openspec-proposal - SKILL.md Agent Skill

name: openspec-proposal description: > Этот скилл MUST быть вызван когда нужна формальная спецификация изменения: scaffold proposal.md, tasks.md, design.md и spec deltas. SHOULD также вызывать для архитектурных или сквозных изменений, требующих формального отслеживания. Do NOT использовать для быстрого обсуждения идей — используй brainstorm; для только декомпозиции задач — используй write-plan. argument-hint: <описание изменения> allowed-tools: - Bash - Read - Write - Edit - Glob - Grep - AskUserQuestion

Guardrails

Минимальные реализации — добавляй сложность только когда запрошено
Строго в рамках запрошенного результата
Читай openspec/AGENTS.md для соглашений OpenSpec
Выявляй неясности и задавай уточняющие вопросы ДО редактирования файлов
НЕ пиши код на этапе proposal. Только документы (proposal.md, tasks.md, design.md, spec deltas)

Steps

Прочитай openspec/project.md, проверь openspec/changes/ и openspec/specs/, изучи связанный код через Grep/Glob
Выбери уникальный change-id (глагол-существительное) и создай scaffold в openspec/changes/<id>/:
- proposal.md — что, зачем, влияние
- tasks.md — упорядоченный чеклист задач
- design.md — архитектурные решения (если нужно)
Маппинг изменения в конкретные capabilities, разбей на spec deltas
Draft spec deltas в changes/<id>/specs/<capability>/spec.md:
- Используй ## ADDED|MODIFIED|REMOVED Requirements
- Минимум один #### Scenario: на каждый requirement
Draft tasks.md — упорядоченный список верифицируемых задач
Валидируй через openspec validate <id> --strict (если CLI доступен) или ручная проверка

Reference

Поиск существующих requirements: Grep "Requirement:|Scenario:" openspec/specs/
Изучай кодовую базу через Grep/Glob для alignment с текущей реализацией