review-spec — скилл для Claude Code: проверяет код на соответствие спекам
Скилл review-spec сверяет написанный код с документами фичи и показывает, где одно разошлось с другим: и код, и устаревшие спеки.
лицензия не указана ★ 155 обновлён 2026-10-29
npx skills add serpro69/claude-toolbox --skill review-spec -a claude-codeЧто делает review-spec
Скилл берёт документы фичи из /docs/feat/wip/[feature]/: design.md, implementation.md, tasks.md. Дальше сверяет их с тем, что уже написано в коде. Запускать можно в середине работы, тогда смотрят только закрытые задачи, или после того, как фича готова. Расхождения ищутся в обе стороны: код ушёл от спеки или спека устарела после правок.
Каждая находка получает тип (MISSING_IMPL, EXTRA_IMPL, SPEC_DEV, DOC_INCON, OUTDATED_DOC, AMBIGUOUS), приоритет от P0 до P3 и оценку уверенности от 1 до 10 с обоснованием. Обычный режим $kk:review-spec идёт одним проходом в текущем контексте. Изолированный $kk:review-spec:isolated отдаёт поиск субагенту spec-reviewer, который код не писал; стоит дороже, а при сбое субагента скилл предложит вернуться к обычному режиму. Для профилей вроде Kubernetes или Terraform манифесты считаются самой реализацией.
Сверять есть что только при живых доках: три файла должны уже лежать в /docs/feat/wip/[feature]/. Перед проверкой скилл читает файлы соглашений репозитория, shared-capy-knowledge-protocol.md и shared-profile-detection.md, и держит жёсткий порядок — сначала спека, потом код. Работает и в Codex.
Какие задачи решает
- поймать требование из
design.md, которое так и не попало в код - найти в коде лишнее, чего спеки не просили
- сверить значения в манифестах Kubernetes с дизайном
- отличить устаревший документ от настоящего расхождения
- получить оценку уверенности по каждой находке перед мержем
Примеры запросов агенту
- Проверь фичу из
/docs/feat/wip/auth/на соответствиеdesign.mdиimplementation.md, запусти$kk:review-spec. - Сделай изолированную проверку через
$kk:review-spec:isolated, код писал не ты. - Сверь только закрытые задачи из
tasks.mdс тем, что уже реализовано, фича ещё в работе.
Как установить review-spec
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-spec -a claude-code2Вручную: положить файлы
~/.claude/skills/review-spec/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/review-spec/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-spec -a codex2Вручную: положить файлы
.agents/skills/review-spec/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-spec -a cursor2Вручную: положить файлы
.cursor/skills/review-spec/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install serpro69/claude-toolbox kodex-plugin/skills/review-spec2Вручную: положить файлы
.github/skills/review-spec/SKILL.md1Через Skills CLI (Vercel)
npx skills add serpro69/claude-toolbox --skill review-spec -a gemini-cli2Командой платформы
gemini skills install https://github.com/serpro69/claude-toolbox --path kodex-plugin/skills/review-specВручную: положить файлы
.devin/skills/review-spec/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о review-spec
Как установить review-spec в Claude Code?
Выполните npx skills add serpro69/claude-toolbox --skill review-spec -a claude-code — скилл появится в ~/.claude/skills/review-spec/SKILL.md.
Что делает review-spec?
Сравнивает реализацию с design.md, implementation.md и tasks.md фичи, находит пропущенное, лишнее и устаревшее, а каждой находке ставит тип, приоритет P0–P3 и оценку уверенности.
Зачем нужен изолированный режим?
Проверку делает отдельный субагент spec-reviewer, который код не писал. Стоит дороже обычного прохода; если субагент не справится, скилл предложит обычный режим.