04-spec — скилл для Claude Code: что делает и как установить
Скилл 04-spec собирает spec.md — контракт одной фичи — из запроса, PRD или замечаний ревью. Или переписывает готовую спеку под найденные проблемы.
MIT ★ 571 обновлён 2026-10-29
/plugin marketplace add ai-driven-dev/framework
/plugin install aidd-pm@aidd-frameworkЧто делает 04-spec
На выходе всегда один файл, spec.md. Режим build делает черновик из запроса или PRD, режим refine берёт существующую спеку вместе с замечаниями ревью и переписывает её. Дальше по цепочке ничего не запускается, результат читают глазами.
Внутри короткая таблица действий и четыре правила. Пробелы в требованиях скилл помечает, а не заполняет догадками. В кодовую базу он не ходит совсем: держит намерение, без «как», с небольшим числом критериев приёмки. Поэтому на вопрос «где именно это сломается в проекте» ответа от него не будет.
Есть ограничение по статусу файла. После валидации спека считается неизменной, и refine не станет править заблокированную версию. Если ждёте правок в документ, который команда уже согласовала, сначала проверьте, не помечен ли он как locked.
Какие задачи решает
- собрать контракт фичи из короткого запроса
- вытащить спеку из готового PRD, не пересказывая весь документ
- переписать спеку под замечания ревью
- пометить открытые вопросы вместо догадок
- удержать требования на уровне намерения, без деталей реализации
Примеры запросов агенту
- Запусти
04-specв режимеbuild: собери спеку по запросу изdocs/request-export.md - Перепиши
specs/export/spec.mdпод замечания ревью, режимrefine - Пройди по
specs/export/spec.mdи пометь пробелы, ничего не додумывая
Как установить 04-spec
1Через маркетплейс плагинов
/plugin marketplace add ai-driven-dev/framework/plugin install aidd-pm@aidd-frameworkКоманда ставит плагин aidd-pm целиком, со всеми его скиллами
2Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 04-spec -a claude-code3Вручную: положить файлы
~/.claude/skills/04-spec/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/04-spec/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 04-spec -a codex2Вручную: положить файлы
.agents/skills/04-spec/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 04-spec -a cursor2Вручную: положить файлы
.cursor/skills/04-spec/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install ai-driven-dev/framework plugins/aidd-pm/skills/04-spec2Вручную: положить файлы
.github/skills/04-spec/SKILL.md1Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 04-spec -a gemini-cli2Командой платформы
gemini skills install https://github.com/ai-driven-dev/framework --path plugins/aidd-pm/skills/04-specВручную: положить файлы
.devin/skills/04-spec/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add ai-driven-dev/framework --skill 04-spec -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о 04-spec
Как установить 04-spec в Claude Code?
Добавьте маркетплейс командой /plugin marketplace add ai-driven-dev/framework, затем поставьте плагин: /plugin install aidd-pm@aidd-framework.
Что делает 04-spec?
Пишет spec.md из запроса или PRD в режиме build и переписывает готовую спеку под замечания ревью в режиме refine. Код не пишет и по репозиторию не ходит.
Можно ли поправить уже утверждённую спеку?
Нет. После валидации спека неизменна, refine работает только с версией, которая ещё не заблокирована.
Исходный текст
SKILL.md · MIT
--- name: 04-spec description: Generate or refine a spec, a feature's immutable contract, from a request, a PRD, or review findings. Use when the user wants to draft or refine a spec. Not for writing code, a full PRD, or changing a locked spec. argument-hint: request | prd | spec --- # Spec ```mermaid flowchart LR request([request or PRD path]) --> build --> done([spec.md]) target([spec path + findings]) --> refine --> done ``` ## Actions Run the flow above. Read only the next action file. | Action | Does | | ------ | -------------------------------------------------- | | build | draft a fresh spec from a request or PRD | | refine | rewrite an existing spec to address findings | ## Transversal rules - Never invent; mark every gap instead of guessing. - Never explore the codebase. - Hold intent, never implementation: solution-agnostic, no how, few acceptance criteria. - Immutable once validated: never rewrite a locked spec.
© AI-Driven Dev · MIT · ai-driven-dev/framework