# speckit-specify

Превращает фразу о фиче в папку со спецификацией: короткое имя, номер, шаблон spec.md и запись в .specify/feature.json.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2600 установок · ★ 153
- Автор: github-spec-kit
- Лицензия: AGPL-3.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-specify/SKILL.md
- Обновлён: 2026-10-23
- HTML: https://affpapa.org/nevibecode/skills/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/`.

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/speckit-specify/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/speckit-specify/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/speckit-specify/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/speckit-specify/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install dceoy/speckit-agent-skills speckit-specify
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/speckit-specify/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/dceoy/speckit-agent-skills --path skills/speckit-specify
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/speckit-specify/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add dceoy/speckit-agent-skills --skill speckit-specify -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/dceoy/speckit-agent-skills/tree/HEAD/skills/speckit-specify/SKILL.md

## Когда брать
- превратить устное описание фичи в файл спецификации
- присвоить фиче короткое имя и номер папки
- подложить нужный шаблон spec.md до начала работы
- связать фичу с последующими командами через .specify/feature.json
- запустить обязательные хуки перед спецификацией

## Примеры запросов агенту
- /speckit-specify Добавить вход через OAuth2 для API
- /speckit-specify Починить таймаут при обработке платежа
- /speckit-specify Сделать дашборд с аналитикой

## Похожие
- [specify](https://affpapa.org/nevibecode/skills/specify.md) — скилл · 2700 установок
- [feature-forge](https://affpapa.org/nevibecode/skills/feature-forge.md) — скилл · 4200 установок
- [elicit](https://affpapa.org/nevibecode/skills/elicit.md) — скилл · 2700 установок
- [distill](https://affpapa.org/nevibecode/skills/distill.md) — скилл · 2600 установок
- [prompt-optimizer](https://affpapa.org/nevibecode/skills/daymade-prompt-optimizer.md) — скилл · 2100 установок
- [spark](https://affpapa.org/nevibecode/skills/spark.md) — скилл · 541 установка

Из того же набора: [dceoy/speckit-agent-skills](https://affpapa.org/nevibecode/by/dceoy/speckit-agent-skills.md) — 9 карточек

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
