status · othmanadi — команда для Claude Code: что делает и как установить
Команда status показывает текущую фазу проекта, процент готовности и ошибки из task_plan.md. Команда запускается для быстрой проверки прогресса без перечитывания всех рабочих файлов.
MIT ★ 28 179 обновлён 2026-11-04
/plugin marketplace add OthmanAdi/planning-with-files
/plugin install planning-with-files@planning-with-filesЧто делает status
Скрипт находит рабочую директорию через resolve-plan-dir.sh или resolve-plan-dir.ps1. Переменная PWF_PLAN_ROOT задаёт корень проекта, а при нескольких планах выбор определяет PLAN_ID. Если найдены конфликтующие планы без явного селектора, скрипт возвращает статус PWF_PLAN_AMBIGUOUS_V1 и останавливает работу, требуя указать слаг вручную.
Команда считывает содержимое только из task_plan.md. Наличие файлов findings.md и progress.md проверяется на диске без их открытия и загрузки в контекст. На экран выводятся номер текущей фазы, список шагов со значками статусов и число ошибок из таблицы Errors Encountered.
Какие задачи решает
- быстро узнать номер текущей фазы и процент выполнения плана
- проверить наличие файлов task_plan.md, findings.md и progress.md
- посчитать зафиксированные ошибки в таблице плана
- определить активный план при наличии переменной PLAN_ID
Примеры запросов агенту
- /planning-with-files:status
- Покажи статус текущего плана и наличие рабочих файлов
- PLAN_ID=refactor-auth покажи прогресс по фазам
Как установить status
1Через маркетплейс плагинов
/plugin marketplace add OthmanAdi/planning-with-files/plugin install planning-with-files@planning-with-files2Вручную: положить файлы
.claude/commands/planning-with-files-status.mdВстроенная /status перекрывает файл с тем же именем, поэтому файл назван иначе. Вызов — /planning-with-files-status. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/status.mdВызов — /prompts:status. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/status.prompt.mdВручную: положить файлы
.gemini/commands/status.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о status
Как установить status в Claude Code?
Сначала добавьте каталог командой /plugin marketplace add OthmanAdi/planning-with-files, затем выполните /plugin install planning-with-files@planning-with-files. Также доступно прямое сохранение в .claude/commands/planning-with-files-status.md.
Что делает команда status?
Она выводит краткую сводку: номер текущей фазы, процент готовности, значки статусов по этапам и число ошибок. Заодно проверяет отметками существование task_plan.md, findings.md и progress.md.
Что произойдёт, если в проекте несколько планов?
Скрипт определит неоднозначность и вернёт PWF_PLAN_AMBIGUOUS_V1. Команда откажется выбирать план наугад и попросит задать конкретный PLAN_ID=<slug>.
Исходный текст
status.md · MIT
---
description: "Show current planning status at a glance - phases, progress, and any logged errors."
---
Resolve the selected task, then read `task_plan.md` from that one directory and display a compact status summary.
## Resolve the Selected Task
Validate `PWF_PLAN_ROOT` as an absolute existing project root when set; refuse an invalid root pin. Otherwise use cwd as the project root. Run `sh ${CLAUDE_PLUGIN_ROOT}/scripts/resolve-plan-dir.sh` (PowerShell: `& "$env:CLAUDE_PLUGIN_ROOT\scripts\resolve-plan-dir.ps1"`):
- A printed directory is the selected task. Read only its `task_plan.md`; check whether `findings.md` and `progress.md` exist without loading their contents. A root `task_plan.md` must not override it.
- Empty output with non-empty `PLAN_ID` means the plan selector was rejected. Report that the pin did not resolve and read nothing else.
- Empty output where `resolve-plan-dir.sh --check-ambiguity` (PowerShell: `-CheckAmbiguity`) prints `PWF_PLAN_AMBIGUOUS_V1` means multiple plans exist without a selector. Report that and ask the user to set `PLAN_ID=<slug>`; do not pick one.
- Otherwise empty output is the legacy project-root convention: read `task_plan.md` from the validated project root (`PWF_PLAN_ROOT` when set), if it exists, and check the companion files there. A valid root pin alone does not reject a legacy root plan. If no plan exists, report that without creating one.
`.planning/.active_plan` is a shared default; it does not bind a parallel session.
## What to Show
1. **Current Phase**: Extract from "## Current Phase" section
2. **Phase Progress**: Count phases and their status (pending/in_progress/complete)
3. **Phase List**: Show each phase with status icon
4. **Errors**: Count entries in "## Errors Encountered" table if present
5. **Files Check**: Confirm which planning files exist
## Status Icons
- `[ ]` or "pending" → ⏸️
- "in_progress" → 🔄
- `[x]` or "complete" → ✅
- "failed" or "blocked" → ❌
## Output Format
```
📋 Planning Status
Current: Phase {N} of {total} ({percent}%)
Status: {status_icon} {status_text}
{icon} Phase 1: {name}
{icon} Phase 2: {name} ← you are here
{icon} Phase 3: {name}
...
Files: task_plan.md {✓|✗} | findings.md {✓|✗} | progress.md {✓|✗}
Errors logged: {count}
```
## If No Planning Files Exist
```
📋 No planning files found
Run /plan to start a new planning session.
```
## Keep It Brief
This is a quick status check, not a full report. Show just enough to answer "where am I?" without re-reading all the files.
© OthmanAdi · MIT · OthmanAdi/planning-with-files
Похожие слэш-команды
Все слэш-команды по теме «Настройка агента: память, контекст, субагенты» →Сначала — status от других авторов.