# openspec-proposal-creation

Готовит структурированную заявку на изменение: proposal.md, tasks.md и spec-delta.md с требованиями в формате EARS. Пригодится, когда новую фичу надо сначала описать, а потом кодить.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 1200 установок · ★ 10
- Автор: forztf
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/forztf/open-skilled-sdd/tree/HEAD/skills/openspec-proposal-creation/SKILL.md
- Обновлён: 2025-11-28
- HTML: https://affpapa.org/nevibecode/skills/openspec-proposal-creation

## Что делает

Скилл ведёт агента по восьми шагам: сначала тот смотрит, какие спецификации уже есть в `spec/specs` и какие изменения висят в `spec/changes`, потом придумывает идентификатор вида `add-user-authentication` и проверяет, не занят ли он. Дальше создаёт папку `spec/changes/{change-id}/specs/{capability-name}` и наполняет её тремя файлами.

\`proposal.md` отвечает на вопросы «зачем», «что меняется» и «кого заденет». `tasks.md` — нумерованный чек-лист внедрения, обычно от 5 до 15 пунктов, с задачами на тесты и документацию. Самый важный файл — `spec-delta.md`: требования пишутся в формате EARS, с заголовками `## ADDED Requirements`, `## MODIFIED Requirements` и `## REMOVED Requirements`, а каждое требование получает сценарий через `#### Scenario:`.

Перед показом заявки скилл прогоняет проверки: считает операции дельта-файла через `grep`, ищет заголовки требований и сценариев. Если пропустить этот шаг, структура поедет и заявку придётся переделывать. Работает в Claude, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install forztf/open-skilled-sdd openspec-proposal-creation
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/forztf/open-skilled-sdd --path skills/openspec-proposal-creation
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add forztf/open-skilled-sdd --skill openspec-proposal-creation -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/forztf/open-skilled-sdd/tree/HEAD/skills/openspec-proposal-creation/SKILL.md

## Когда брать
- описать новую фичу до начала кода
- зафиксировать ломающее изменение и его последствия
- составить чек-лист внедрения с тестами
- оформить удаление устаревшей возможности
- проверить структуру заявки до согласования

## Примеры запросов агенту
- создай openspec proposal для добавления авторизации пользователей
- проверь существующие спецификации и предложи change ID для новой фичи
- сделай spec delta с требованиями в формате EARS для изменения лимитов API

## Похожие
- [proposal-writer](https://affpapa.org/nevibecode/skills/jezweb-proposal-writer.md) — скилл · 1200 установок
- [investment-proposal](https://affpapa.org/nevibecode/skills/investment-proposal.md) — скилл · 1100 установок
- [contract-and-proposal-writer](https://affpapa.org/nevibecode/skills/contract-and-proposal-writer.md) — скилл · 747 установок
- [openspec-update-change](https://affpapa.org/nevibecode/skills/openspec-update-change.md) — скилл · 4500 установок
- [openspec-onboard](https://affpapa.org/nevibecode/skills/openspec-onboard.md) — скилл · 4000 установок
- [user-guide-creation](https://affpapa.org/nevibecode/skills/user-guide-creation.md) — скилл · 751 установка

Из того же набора: [forztf/open-skilled-sdd](https://affpapa.org/nevibecode/by/forztf/open-skilled-sdd.md) — 2 карточки

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