speckit-clarify — скилл для Claude Code: вопросы к спецификации
Находит недосказанное в спецификации фичи: задаёт до 5 точных вопросов и записывает ответы прямо в файл спеки.
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-codeЧто делает speckit-clarify
Скилл читает текущую спецификацию фичи и проходит её по категориям: цели и критерии успеха, модель данных, сценарии пользователя, нефункциональные требования, внешние зависимости, граничные случаи, терминология. По каждой категории он отмечает состояние — ясно, частично или пропущено — и по пробелам строит очередь вопросов.
Вопросов не больше пяти за сессию, и все они требуют короткого ответа: выбор из 2–5 вариантов или фраза до пяти слов. Спрашивает по одному, а не списком. Ответы кодируются обратно в спеку, так что файл обновляется по ходу разговора.
Работает в проекте со структурой spec-kit: нужен каталог .specify/ со скриптами и файлом конституции проекта. Без него шаг проверки предпосылок упадёт, и скилл попросит сначала прогнать /speckit-specify. Запускать его стоит до /speckit-plan — если пропустить уточнения, переделывать план придётся дороже.
Какие задачи решает
- вытащить из черновой спеки решения, которые автор не проговорил
- закрыть пробелы в критериях приёмки до старта планирования
- зафиксировать ответы по краевым случаям прямо в файле спецификации
- сверить спеку с конституцией проекта и найти расхождения
- ограничить разбор пятью вопросами, чтобы не увязнуть в интервью
Примеры запросов агенту
- прогони /speckit-clarify по текущей спеке
- уточни спеку: меня интересуют состояния загрузки и ошибок
- /speckit-clarify безопасность и работа с персональными данными
Как установить speckit-clarify
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-code2Вручную: положить файлы
~/.claude/skills/speckit-clarify/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/speckit-clarify/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a codex2Вручную: положить файлы
.agents/skills/speckit-clarify/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a cursor2Вручную: положить файлы
.cursor/skills/speckit-clarify/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills speckit-clarify2Вручную: положить файлы
.github/skills/speckit-clarify/SKILL.md1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a gemini-cli2Командой платформы
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-clarifyВручную: положить файлы
.devin/skills/speckit-clarify/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о speckit-clarify
Как установить speckit-clarify в Claude?
Выполните npx skills add dceoy/speckit-agent-skills --skill speckit-clarify -a claude-code. Скилл встанет в ~/.claude/skills/speckit-clarify/SKILL.md.
Что делает speckit-clarify?
Сканирует спецификацию фичи на неоднозначности и пробелы, задаёт до 5 коротких вопросов и записывает ответы в тот же файл спеки.
Что нужно, чтобы скилл заработал?
Проект со структурой spec-kit и каталогом .specify/. Если проверка предпосылок не проходит, скилл предложит сначала выполнить /speckit-specify.