speckit.companion.resume — команда для Claude Code
Команда speckit.companion.resume для Claude Code восстанавливает состояние spec-driven разработки после перерыва. Она переносит записанные решения в контекст и запускает следующий шаг пайплайна.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.companion.resume.mdЧто делает speckit.companion.resume
Команда работает внутри spec-kit — фреймворка для пошагового проектирования через спеки. Когда разработчик прерывает работу на любом этапе (план, задачи, реализация), speckit.companion.resume восстанавливает прогресс: читает .spec-context.json или состояние файлов на диске, определяет, на каком шаге остановились, и переносит все записанные решения в контекст для следующей команды.
Как это работает: скрипт status-context.py разбирает сохранённое состояние и выдаёт инструкцию дальше. Если пайплайн завершён — резюме останавливается. Если внутри этапа реализации остались невыполненные задачи — резюме запускает speckit.implement с указанием на следующую задачу. Иначе резюме вызывает нужную команду: speckit.plan, speckit.tasks или другую.
Требует Python 3 в PATH. Если его нет — команда выведет предупреждение и корректно завершится, не ломая хост.
Какие задачи решает
- возобновить разработку по спеку после перерыва
- сохранить и перенести принятые решения на следующий шаг
- продолжить реализацию со следующей невыполненной задачи
- избежать повторного ввода параметров и контекста при восстановлении
Примеры запросов агенту
- Вызови резюме, чтобы вернуться к спеку, который я начал вчера
- Запусти
speckit.companion.resumeи продолжи реализацию оттуда, где я остановился - После возвращения к проекту дай мне резюме о следующем шаге в спеке
Как установить speckit.companion.resume
Вручную: положить файлы
.claude/commands/speckit.companion.resume.mdВызов — /speckit.companion.resume. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/speckit.companion.resume.mdВызов — /prompts:speckit.companion.resume. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.companion.resume.prompt.mdВручную: положить файлы
.gemini/commands/speckit.companion.resume.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о speckit.companion.resume
Как установить speckit.companion.resume в Claude Code?
Скопируй файл .claude/commands/speckit.companion.resume.md в .claude/commands/ своего проекта, если его там нет. Claude Code автоматически подхватит команду и зарегистрирует её как /speckit-companion-resume.
Что делает speckit.companion.resume?
Она читает сохранённое состояние спека, восстанавливает все принятые решения и автоматически запускает следующую команду пайплайна — будь то план, задачи или реализация. Если внутри реализации остались задачи, резюме продолжит их выполнение.
Что нужно, чтобы команда сработала?
Проект должен содержать spec-kit с инициализированным состоянием (папка specs/ с фичами и файл .spec-context.json или состояние на диске). Python 3 должен быть доступен в PATH; если его нет, команда выведет предупреждение и безопасно завершится.
Исходный текст
speckit.companion.resume.md · MIT
---
description: "Continue the spec-driven pipeline from the last completed step, carrying recorded decisions into scope, and dispatch the next command"
---
# Resume Spec
Pick the pipeline back up where it stopped. This command reads the active
feature's recorded state, resolves the next step — carrying the recorded
`decisions` into scope — and dispatches the next `speckit.*` command. Inside the
implement step it continues at the next unchecked task.
<!-- speckit-companion:part command-spelling -->
## Name every command the way this project registers it
Commands are named in dot form throughout this body, `speckit.companion.plan`, because that is their canonical id, and without a leading slash, because the spelling a host actually registers is not always this one. Claude Code installs `/speckit-companion-plan`. Look at how the commands are installed in this project, under the agent's own commands or skills directory, and use that spelling every time you name one to the developer or dispatch one yourself. A dotted name typed into a host that registered dashes resolves to nothing at all.
<!-- /speckit-companion:part command-spelling -->
## Prerequisites
- Verify Python is available by running `python3 --version`.
- If `python3` is not available, warn the user and skip:
`[companion] Warning: python3 not detected; skipped resume`.
Do not fail the host command.
## Execution
1. Resolve the next action from the repository root:
```bash
python3 .specify/extensions/companion/scripts/status-context.py
```
(Pass `--feature-dir specs/<NNN>-<slug>` when you already know it.) The script
reads `.spec-context.json`, or derives state from on-disk files when it is
missing/malformed.
2. Parse the final `RESOLUTION: { … }` JSON line the script prints. It contains
`currentStep`, `status`, `decisions[]`, `nextStep`, `nextCommand`,
`nextActionLabel`, `nextTask`, and `complete`.
3. Branch on the resolution:
- **`complete: true`** → print `Pipeline complete — nothing to resume.` and stop.
Do not dispatch anything.
- **`empty: true`** (no recorded state and no spec files) → print
`Nothing to resume (no spec files or recorded state found).` and stop.
- **`nextTask` is set** (inside the implement step) → continue implementation at
`nextTask`: invoke `speckit.implement`, instructing it to resume at the next
unchecked task.
- **otherwise** → invoke `nextCommand` (e.g. `speckit.plan`, `speckit.tasks`,
`speckit.implement`).
4. When you dispatch, state the recorded `decisions[]` as in-scope context for the
step you are running, so prior decisions carry forward and the user does not
re-specify them.
## Dispatch note
Resume dispatches the **already-installed** `speckit.*` commands. It does not
require a `specify workflow resume` CLI subcommand, so it works on the stock
installed spec-kit version. The dispatched command runs its own `after_*` capture
hook, which writes the resulting `history[]` entry — resume itself writes no state.
## Output
```text
Resuming <name> from <currentStep> (<status>).
Decisions in scope:
- <decision>
Next: <action> → dispatching <command>
```
- Tasks/implement step → `Next: Continue implementation at <task> → dispatching speckit.implement`.
- No decisions recorded → omit the "Decisions in scope" block.
## Graceful Degradation
Best-effort: if `python3` is missing or the feature directory cannot be resolved,
warn to stderr and stop without dispatching. Never fail the host command.
© alfredoperez · MIT · alfredoperez/speckit-companion