speckit-specify — скилл для Claude Code: спецификация из описания
Превращает фразу о фиче в папку со спецификацией: короткое имя, номер, шаблон spec.md и запись в .specify/feature.json.
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a claude-codeЧто делает speckit-specify
Скилл берёт текст, который вы написали после вызова, и делает из него заготовку спецификации. Сначала он вытаскивает из описания ключевые слова и собирает короткое имя на 2–4 слова в формате действие-существительное, вроде add-user-auth или fix-payment-timeout. Потом создаёт папку под specs/, копирует туда активный шаблон spec-template как spec.md и записывает путь в .specify/feature.json, чтобы следующие команды цепочки нашли фичу без опоры на имя git-ветки.
Номер папки зависит от .specify/init-options.json: при feature_numbering: timestamp это метка времени, при sequential или её отсутствии — следующий свободный трёхзначный номер. Если в файле остался устаревший ключ branch_numbering, скилл скажет об этом одной строкой. Имя git-ветки и имя папки здесь независимы, совпадать они не обязаны.
Перед работой скилл смотрит в .specify/extensions.yml и ищет хуки before_specify. Обязательные (optional: false) он запускает сам и ждёт результата, необязательные просто показывает командой. Если YAML не парсится, скилл сообщит об ошибке и о том, что хуки не проверялись, — молча пропустить сломанный файл он не должен. За один вызов создаётся ровно одна фича. Для работы нужна структура проекта spec-kit с каталогом .specify/.
Какие задачи решает
- превратить устное описание фичи в файл спецификации
- присвоить фиче короткое имя и номер папки
- подложить нужный шаблон spec.md до начала работы
- связать фичу с последующими командами через .specify/feature.json
- запустить обязательные хуки перед спецификацией
Примеры запросов агенту
- /speckit-specify Добавить вход через OAuth2 для API
- /speckit-specify Починить таймаут при обработке платежа
- /speckit-specify Сделать дашборд с аналитикой
Как установить speckit-specify
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a claude-code2Вручную: положить файлы
~/.claude/skills/speckit-specify/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/speckit-specify/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a codex2Вручную: положить файлы
.agents/skills/speckit-specify/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a cursor2Вручную: положить файлы
.cursor/skills/speckit-specify/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install dceoy/speckit-agent-skills speckit-specify2Вручную: положить файлы
.github/skills/speckit-specify/SKILL.md1Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a gemini-cli2Командой платформы
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-specifyВручную: положить файлы
.devin/skills/speckit-specify/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о speckit-specify
Как установить speckit-specify в Claude?
Выполните npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a claude-code. Скилл появится по пути ~/.claude/skills/speckit-specify/SKILL.md.
Что делает speckit-specify?
Создаёт или обновляет спецификацию фичи по её описанию на естественном языке: генерирует короткое имя, заводит папку под specs/, копирует туда шаблон spec.md и сохраняет путь в .specify/feature.json.
Что нужно, чтобы скилл заработал?
Структура проекта spec-kit с каталогом .specify/. Хуки читаются из .specify/extensions.yml, а нумерация папок — из .specify/init-options.json.
