# spec

Превращает сырую идею фичи в письменную спецификацию с критериями приёмки. Задаёт вопросы раундами, пока не закроет все пробелы.

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

## Что делает

Скилл ведёт разработчика через девять измерений: проблема и пользователи, границы итерации, доменная модель, контракт API, авторизация, краевые случаи, нефункциональные требования, интеграции, критерии приёмки. Вопросы идут раундами по 3–5 штук, а не одной свалкой. Ответы сразу ложатся в черновик спецификации, потому что это требования, а не болтовня.

Результат — файл `docs/specs/<NNN>-<slug>.md` со статусами Draft → In Review → Approved. Пока в разделе Open Questions что-то осталось, утвердить спецификацию нельзя: каждый открытый вопрос либо закрывают, либо переносят в Deferred Decisions с явным запасным вариантом. Молчаливое «потом решим» здесь не проходит.

Дальше файл читают `/plan`, `/scaffold` и `/tdd`: критерии приёмки превращаются в шаги реализации и первые падающие тесты. Если по ходу кода всплыло неверное допущение, статус возвращают в In Review и правят спецификацию, а не код втихую. Для багфиксов и мелкого CRUD с очевидной сущностью скилл не нужен — он про фичи, которые в одно предложение не влезают.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add codewithmukesh/dotnet-claude-kit --skill spec -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add codewithmukesh/dotnet-claude-kit --skill spec -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install codewithmukesh/dotnet-claude-kit spec
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add codewithmukesh/dotnet-claude-kit --skill spec -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- /spec пользователи должны приглашать коллег в организацию
- /spec напиши спецификацию для экспорта отчётов в PDF
- /spec требования к модулю командных пространств

## Похожие
- [sparc-spec](https://affpapa.org/nevibecode/skills/sparc-spec.md) — скилл · 732 установки
- [spec-driven-workflow](https://affpapa.org/nevibecode/skills/spec-driven-workflow.md) — скилл · 600 установок
- [write-spec](https://affpapa.org/nevibecode/skills/write-spec.md) — скилл · 3600 установок
- [cursor-spec-interviewer](https://affpapa.org/nevibecode/skills/cursor-spec-interviewer.md) — скилл · 2600 установок
- [feature-forge](https://affpapa.org/nevibecode/skills/feature-forge.md) — скилл · 4200 установок
- [user-story-writing](https://affpapa.org/nevibecode/skills/user-story-writing.md) — скилл · 787 установок

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

Из того же набора: [codewithmukesh/dotnet-claude-kit](https://affpapa.org/nevibecode/by/codewithmukesh/dotnet-claude-kit.md) — 46 карточек

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

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