speckit.companion.classify — команда для Claude Code
Команда speckit.companion.classify для Claude Code оценивает масштаб изменений по spec.md и выдаёт вердикт: simple, normal или oversized. Определяет сценарий работы в Speckit Companion без ручных переключателей.
MIT ★ 110 обновлён 2026-10-19
.claude/commands/speckit.companion.classify.mdЧто делает speckit.companion.classify
Команда работает исключительно на чтение. Она просматривает spec.md, а также plan.md и tasks.md, если те уже созданы в проекте. Никаких правок в спецификации команда не вносит и служебный файл .spec-context.json не перезаписывает. Итоговый результат отдаётся одной строкой [companion] size=<simple|normal|oversized> в лог и дублируется в структурированный вывод для узлов маршрутизации.
Категорию simple получают задачи объёмом не более 5 файлов и до 10 шагов, если их легко проверить и отменить. Если же изменение затрагивает миграции базы данных, удаление сохранённой информации или публичные контракты, команда никогда не сочтёт задачу простой. В сомнительных ситуациях и при масштабных правках назначается normal либо выводится предупреждение oversized, чтобы воркфлоу гарантированно выполнил все фазы пайплайна.
Какие задачи решает
- оценить объём доработки по файлу spec.md
- определить категорию сложности задачи перед запуском воркфлоу
- проверить число затрагиваемых файлов и шагов плана
- предотвратить пропуск проверок при рискованных миграциях
Примеры запросов агенту
- /speckit.companion.classify
- Оцени размер изменений по spec.md через команду /speckit.companion.classify
Как установить speckit.companion.classify
Вручную: положить файлы
.claude/commands/speckit.companion.classify.mdВызов — /speckit.companion.classify. Для всех проектов — ~/.claude/commands/
Вручную: положить файлы
~/.codex/prompts/speckit.companion.classify.mdВызов — /prompts:speckit.companion.classify. В Codex этот формат помечен устаревшим, замена — скиллы
Вручную: положить файлы
.github/prompts/speckit.companion.classify.prompt.mdВручную: положить файлы
.gemini/commands/speckit.companion.classify.tomlGemini хранит команды в TOML: текст запроса — в поле prompt
Вопросы о speckit.companion.classify
Как установить speckit.companion.classify в Claude Code?
Сохраните файл команды по пути .claude/commands/speckit.companion.classify.md.
Что делает speckit.companion.classify?
Команда оценивает требования в spec.md и возвращает один из трёх уровней сложности: simple, normal или oversized. Она не меняет файлы проекта.
Почему правка из двух файлов может получить статус normal?
Если изменения сложно откатить или проверить — например, при миграциях БД или удалении данных — статус simple блокируется вне зависимости от количества файлов.
Исходный текст
speckit.companion.classify.md · MIT
--- description: "Classify the change size (simple | normal | oversized) so the Companion workflow can right-size the pipeline" --- # Classify Change Size Emit a single complexity signal — `simple`, `normal`, or `oversized` — that the Companion workflow's routing step reads to right-size the pipeline. On the workflow path there is no `complexityFastPath` on/off setting: the thresholds live here, in the workflow, not in a VS Code toggle. This is a **thin, read-only** step. It does not write `.spec-context.json` and does not create or edit any spec files; it only reports a size. ## Heuristic (thresholds live here, not in a setting) Estimate the scope of the change from `spec.md` (and `plan.md`/`tasks.md` if they already exist): <!-- speckit-companion:part sizing --> - **small**: the change plausibly touches **≤ 5 files** and decomposes into **≤ 10 tasks**, and is easy to undo and easy to check. A change that is hard to reverse (a migration, deleted stored data, a published contract) or hard to verify is never small, whatever its file count. - **oversized**: the change clearly exceeds the small bar by a wide margin (broad multi-subsystem work, many new files, or a long task list). - **normal**: anything in between (the default). <!-- /speckit-companion:part sizing --> When unsure, prefer `normal` — the routing step's safe default is the full pipeline, so an ambiguous estimate never skips a phase. ## Output Print exactly one line so the size is visible in the run log: ```text [companion] size=<simple|normal|oversized> ``` Expose the same value as structured output `size` (so a `switch` node can read `steps.classify.output.size`). Routing contract: <!-- speckit-companion:part routing --> - `simple` → the workflow folds toward implement (less ceremony). `simple` is the verdict every reader of the recorded size expects; `small` names the *bar*, never the verdict. - `oversized` → the workflow prints a visible warning and still runs the **full** pipeline. It never silently skips a phase. - `normal` (and any unresolved value) → the full pipeline. <!-- /speckit-companion:part routing -->
© alfredoperez · MIT · alfredoperez/speckit-companion