speckit-baseline — скилл для Claude Code: спека по существующему коду
Скилл читает ваш код и собирает из него технонейтральную спецификацию с пользовательскими историями и требованиями. Пригодится, когда код есть, а записанных требований к нему нет.
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a claude-codeЧто делает speckit-baseline
Скилл берёт путь, список файлов или glob-шаблон, разворачивает его в список файлов, читает исходники и разбирает структуру: точки входа, публичные интерфейсы, сигнатуры функций, модели данных, маршруты API. Язык и фреймворк определяет по коду. Потом придумывает короткое имя на 2–4 слова в формате «действие-существительное» и вызывает .specify/scripts/bash/create-new-feature.sh --json, чтобы завести ветку и файл спеки. Шаблон берётся из .specify/templates/spec-template.md.
В спеке появляются пользовательские истории, сценарии приёмки, функциональные требования, ключевые сущности и критерии успеха. Реализацию скилл абстрагирует: if (user.role === 'admin') превращается в требование ограничить действие администраторами. Места, где поведение кода непонятно, помечаются [NEEDS CLARIFICATION], не больше трёх за раз. Выводы, сделанные по ходу анализа, попадают в раздел допущений, а в FEATURE_DIR/checklists/requirements.md создаётся чек-лист качества.
Нужен репозиторий с настроенным .specify/ — скриптами и шаблонами. Если target пустой или неоднозначный, скилл останавливается и задаёт уточняющий вопрос. Готовую спеку должен вычитать человек, который знает эту функциональность: иначе в требованиях останутся ошибки интерпретации. Сгенерированный spec.md потом разбирают через speckit-clarify и планируют рефакторинг через speckit-plan.
Какие задачи решает
- получить спеку по унаследованному коду без документации
- описать фичу перед рефакторингом
- вытащить бизнес-правила из условий в коде
- зафиксировать требования из маршрутов API и моделей данных
- отметить места, где поведение кода неочевидно
Примеры запросов агенту
- Собери спецификацию по
src/auth/и покажи, что осталось неясным - Проанализируй
src/services/*.tsи заведи ветку со спекой по платежам - Разбери легаси-модуль
legacy/orders.pyи оформи его как спеку
Как установить speckit-baseline
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a claude-code2Вручную: положить файлы
~/.claude/skills/speckit-baseline/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/speckit-baseline/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a codex2Вручную: положить файлы
.agents/skills/speckit-baseline/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a cursor2Вручную: положить файлы
.cursor/skills/speckit-baseline/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills speckit-baseline2Вручную: положить файлы
.github/skills/speckit-baseline/SKILL.md1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a gemini-cli2Командой платформы
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-baselineВручную: положить файлы
.devin/skills/speckit-baseline/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о speckit-baseline
Как установить speckit-baseline в Claude Code?
Выполните npx skills add dceoy/speckit-agent-skills --skill speckit-baseline -a claude-code. Скилл появится в ~/.claude/skills/speckit-baseline/SKILL.md.
Что делает speckit-baseline?
Читает указанные файлы, разбирает структуру кода и создаёт ветку с файлом specs/<feature>/spec.md по шаблону Spec Kit. В спеке описаны пользовательские истории, требования и критерии успеха без привязки к фреймворку.
Что нужно, чтобы скилл заработал?
Репозиторий с каталогом .specify/: скриптом create-new-feature.sh и шаблоном spec-template.md. Без них шаг создания ветки и спеки не пройдёт.
