requirements-clarity — скилл для Claude Code: суть и установка
Превращает размытые запросы на разработку в структурированное ТЗ через диалог. Скилл задаёт наводящие вопросы и генерирует PRD, когда накопит достаточно деталей.
npx claude-code-templates@latest --skill productivity/requirements-clarityЧто делает requirements-clarity
Скилл перехватывает общие формулировки вроде «сделай авторизацию» или «добавь дашборд». Вместо того чтобы сразу писать код вслепую, он оценивает исходные требования по стобалльной шкале. В расчёт берутся четыре блока: функциональные рамки (до 30 баллов), технические ограничения (до 25), полнота сценариев и граничных случаев (до 25) и бизнес-контекст (до 20).
Диалог строится короткими сериями по две-три подсказки за раунд, без перегрузки лишними деталями. После каждого ответа итоговый балл пересчитывается. Как только планка ясности превышает 90 баллов, инструмент автоматически формирует файл ./docs/prds/{feature_name}-v{version}-prd.md со структурой требований, архитектурными решениями и критериями приёмки.
Поведение строго ограничено: скилл не станет запускаться при наличии готовых сниппетов кода, точных путей к файлам вроде auth.go:45 или пошаговых инструкций к багфиксам.
Какие задачи решает
- структурировать размытое описание фичи в понятный PRD
- выявить неучтённые граничные случаи и обработку ошибок до начала кодинга
- зафиксировать критерии приёмки и технические ограничения проекта
- отсечь лишний скоуп задачи через проверки YAGNI и KISS
Примеры запросов агенту
- Спланируй фичу личного кабинета пользователя и подготовь PRD
- Нам нужно добавить экспорт отчётов в CSV, задай нужные вопросы по скоупу
- Помоги детализировать требования к интеграции с платёжным шлюзом
Как установить requirements-clarity
1Через claude-code-templates
npx claude-code-templates@latest --skill productivity/requirements-clarity2Через Skills CLI (Vercel)
npx skills add davila7/claude-code-templates --skill requirements-clarity -a claude-code3Вручную: положить файлы
~/.claude/skills/requirements-clarity/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/requirements-clarity/
Вручную: положить файлы
.agents/skills/requirements-clarity/SKILL.mdДля всех проектов — ~/.agents/skills/
Вручную: положить файлы
.cursor/skills/requirements-clarity/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install davila7/claude-code-templates requirements-clarity2Вручную: положить файлы
.github/skills/requirements-clarity/SKILL.mdКомандой платформы
gemini skills install https://github.com/davila7/claude-code-templates --path cli-tool/components/skills/productivity/requirements-clarityВручную: положить файлы
.devin/skills/requirements-clarity/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Claude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о requirements-clarity
Как установить requirements-clarity в Claude Code?
Запустите команду npx claude-code-templates@latest --skill productivity/requirements-clarity или выполните npx skills add davila7/claude-code-templates --skill requirements-clarity -a claude-code.
Что делает скилл requirements-clarity?
Он ведёт пошаговый опрос по 100-балльной системе оценки ясности и сохраняет готовый документ требований в папку ./docs/prds/.
В каких случаях скилл не станет вмешиваться в диалог?
Логика пропускает запросы с готовыми фрагментами кода, указаниями на конкретные строки и файлы вроде auth.go:45, а также багрепорты с воспроизводимыми шагами.