spec-writer — скилл для Claude Code: спецификация из описания
Превращает туманное описание фичи в структурированный спек, технический план и список задач. Помечает каждое предположение прямо в тексте, чтобы вы могли исправить неточности до того, как агент начнёт кодить.
npx skills add dannwaneri/spec-writer --skill spec-writer -a claude-codeЧто делает spec-writer
spec-writer берёт фразу вроде «добавить сброс пароля» и выдаёт трёхчастный документ: спек с требованиями и критериями приёма (в формате Given/When/Then), план архитектуры и изменений данных, и разбор на упорядоченные задачи. Каждое допущение помечается [ASSUMPTION: ...] прямо в тексте — это быстрее, чем вопросы-ответы, и видно сразу, какие решения ещё не приняты.
Выход совместим с GitHub Spec Kit и OpenSpec, так что можно сохранить результат в .specify/ или openspec/changes/ и продолжить с фреймворка. Спек остаётся технологически нейтральным — без привязки к конкретному фреймворку, только функциональные требования и бизнес-логика.
Какие задачи решает
- собрать спецификацию из краткого описания фичи
- разбить туманный запрос на конкретные задачи для агента
- выделить предположения до начала разработки
- создать техплан с моделью данных и контрактами API
- подготовить документ, совместимый с Spec Kit или OpenSpec
Примеры запросов агенту
- /spec-writer Добавить возможность сбросить пароль пользователю
- /spec-writer Собрать дашборд администратора с графиком регистраций
- /spec-writer Позволить экспортировать данные в CSV
Как установить spec-writer
1Через Skills CLI (Vercel)
npx skills add dannwaneri/spec-writer --skill spec-writer -a claude-code2Вручную: положить файлы
~/.claude/skills/spec-writer/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/spec-writer/
1Через Skills CLI (Vercel)
npx skills add dannwaneri/spec-writer --skill spec-writer -a codex2Вручную: положить файлы
.agents/skills/spec-writer/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dannwaneri/spec-writer --skill spec-writer -a cursor2Вручную: положить файлы
.cursor/skills/spec-writer/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dannwaneri/spec-writer spec-writer2Вручную: положить файлы
.github/skills/spec-writer/SKILL.md1Через Skills CLI (Vercel)
npx skills add dannwaneri/spec-writer --skill spec-writer -a gemini-cli2Командой платформы
gemini skills install https://github.com/dannwaneri/spec-writerВручную: положить файлы
.devin/skills/spec-writer/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dannwaneri/spec-writer --skill spec-writer -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о spec-writer
Как установить spec-writer в Claude Code?
Выполните npx skills add dannwaneri/spec-writer --skill spec-writer -a claude-code, затем найдите файл конфигурации в ~/.claude/skills/spec-writer/SKILL.md.
Что именно генерирует spec-writer?
Три раздела: спецификацию с use cases и критериями приёма, техплан с архитектурой и контрактами API, и список упорядоченных задач. Каждое неявное решение помечено [ASSUMPTION: ...], которое вы можете исправить.
Совместим ли вывод spec-writer с фреймворками вроде Spec Kit?
Да, формат совместим с GitHub Spec Kit и OpenSpec. Спите выход можно сохранить в директорию .specify/ или openspec/changes/ и продолжить работу в самом фреймворке.
