# spec

Скилл пишет одну готовую к реализации спецификацию на одно изменение: поведение, техдизайн, обработка сбоев и проверки приёмки.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 402 установки · ★ 420
- Автор: owainlewis
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/owainlewis/blueprint/tree/HEAD/skills/spec/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/owainlewis-spec

## Что делает

Скилл `spec` превращает запрос в спецификацию, по которой можно работать без догадок. Источником служит `docs/<feature-slug>/spec.md`, GitHub issue или другой документ от пользователя. Если источник передан, скилл обновляет его, а не заводит второй тикет. Без источника берёт путь выше. Публикует в трекер только по просьбе.

Процесс разбит на пять шагов. Сначала скилл читает запрос, инструкции репозитория, требования, архитектуру и релевантный код, проверяя утверждения о текущем поведении. Потом фиксирует результат и границы, спрашивает про нерешённые развилки, которые меняют поведение, данные, интерфейсы, безопасность или стоимость. Дальше пишет спеку по заданной форме: результат и границы, требуемое поведение с ссылками на `REQ-n`, технический дизайн, приёмка и доказательства в таблице с `AC-n`, открытые решения. Завершает проверкой: свежий агент должен реализовать спеку, не изобретая значимых решений. На этом скилл останавливается и не планирует задачи.

Важная деталь: `disable-model-invocation: true` в описании скилла. Модель не вызовет его сама, запускать нужно вручную. Схему, индексы, миграции, транзакции и откат скилл описывает только там, где они затрагивают изменение. Мелкие уже решённые правки можно вести без формальной спеки.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add owainlewis/blueprint --skill spec -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add owainlewis/blueprint --skill spec -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add owainlewis/blueprint --skill spec -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install owainlewis/blueprint spec
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add owainlewis/blueprint --skill spec -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add owainlewis/blueprint --skill spec -a opencode
```

### Claude.ai

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

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

## Когда брать
- зафиксировать поведение фичи до начала кода
- согласовать технический дизайн и границы изменения
- описать обработку ошибок и частичных сбоев
- связать условия приёмки с конкретными проверками
- сохранить спеку как запись решений после поставки

## Примеры запросов агенту
- /spec добавь экспорт отчёта в CSV
- /spec переведи оплату на новый провайдер
- /spec обнови спеку docs/export/spec.md под частичные сбои

## Похожие
- [4-spec](https://affpapa.org/nevibecode/skills/4-spec.md) — скилл · 1800 установок
- [cursor-spec-interviewer](https://affpapa.org/nevibecode/skills/cursor-spec-interviewer.md) — скилл · 2600 установок
- [adopt-spec](https://affpapa.org/nevibecode/skills/adopt-spec.md) — скилл · 1800 установок
- [code-to-spec](https://affpapa.org/nevibecode/skills/code-to-spec.md) — скилл · 470 установок
- [write-spec](https://affpapa.org/nevibecode/skills/write-spec.md) — скилл · 3600 установок
- [spec-impl](https://affpapa.org/nevibecode/skills/spec-impl.md) — скилл · 4000 установок

## Другие версии с тем же именем
- [spec · klerith](https://affpapa.org/nevibecode/skills/spec.md) — 4100 установок
- [spec · juliusbrussee](https://affpapa.org/nevibecode/skills/juliusbrussee-spec.md) — 2700 установок
- [spec · codewithmukesh](https://affpapa.org/nevibecode/skills/codewithmukesh-spec.md) — 2800 установок

Из того же набора: [owainlewis/blueprint](https://affpapa.org/nevibecode/by/owainlewis/blueprint.md) — 4 карточки

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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