# pm-spec-writing

Скилл pm-spec-writing переводит идеи и запросы в понятные разработчикам ТЗ, спеки и баги. Помогает уточнить, что именно нужно построить, прежде чем писать код.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 286 установок · ★ 1107 у репозитория
- Автор: rampstackco
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/rampstackco/claude-skills/tree/HEAD/skills/pm-spec-writing/SKILL.md
- Обновлён: 2026-10-19
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/pm-spec-writing

## Что делает

Скилл превращает размытые идеи в конкретные задачи для разработки. Когда пользователь говорит «хочу добавить», «нам нужно», «как это реализовать», скилл запускает структурированный процесс: сначала уточняет проблему и метрику успеха, затем оценивает объём работы, потом пишет спек в одном из трёх форматов — полная фиче-спека, короткий девелоперский бриф или баг-репорт.

В основе четыре фазы: уточнение идеи (проблема, целевая аудитория, метрика, причина срочности), оценка по матрице влияния и трудозатрат, выбор формата вывода (спека для новых фич, бриф для тактических задач, репорт для багов), и наконец — разбор на шагуемые инкременты. Каждый формат содержит обязательные поля: acceptance criteria, dependencies, success metric, verify steps. Пустые поля — флаг того, что задача недоработана.

## Установка

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

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

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

### Codex

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

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

### Cursor

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

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install rampstackco/claude-skills skills/pm-spec-writing
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add rampstackco/claude-skills --skill pm-spec-writing -a opencode
```

### Claude.ai

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

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

## Когда брать
- Переводить расплывчатую идею в конкретный план работ
- Писать acceptance criteria и verify steps, которые разработчик понимает правильно
- Расставлять приоритеты и выбирать, что строить в первую очередь
- Оформить баг-репорт так, чтобы его было просто воспроизвести
- Разбить большую фичу на части, которые можно шипнуть отдельно

## Примеры запросов агенту
- Напиши фиче-спеку: нам нужна возможность экспортировать результаты в PDF с кастомными шаблонами
- Помоги расставить приоритеты: у нас есть список фич, оцени по матрице влияния и трудозатрат
- Напиши девелоперский бриф для добавления пагинации в API `users` с лимитом по умолчанию 20

## Похожие
- [om-spec-writing](https://affpapa.org/nevibecode/skills/om-spec-writing.md) — скилл · 3900 установок
- [write-spec](https://affpapa.org/nevibecode/skills/write-spec.md) — скилл · 3800 установок
- [writing-prds](https://affpapa.org/nevibecode/skills/writing-prds.md) — скилл · 3500 установок
- [prd-writing](https://affpapa.org/nevibecode/skills/prd-writing.md) — скилл · 722 установки
- [om-auto-write-spec](https://affpapa.org/nevibecode/skills/om-auto-write-spec.md) — скилл · 3900 установок
- [bmad-epics-and-stories](https://affpapa.org/nevibecode/skills/bmad-epics-and-stories.md) — скилл · 138 установок

Из того же набора: [rampstackco/claude-skills](https://affpapa.org/nevibecode/by/rampstackco/claude-skills.md) — 102 карточки

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

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