43b60d6101
* feat(feature-spec): add SDD-style Q&A skill for feature planning * docs(pr-172): add handoff, ADR-072, update project-map --------- Co-authored-by: opencode-agent <agent@opencode.local>
31 lines
2.3 KiB
Markdown
31 lines
2.3 KiB
Markdown
---
|
||
pr: 172
|
||
title: feat(feature-spec): add SDD-style Q&A skill for feature planning
|
||
---
|
||
|
||
## Что сделано
|
||
|
||
- `.opencode/commands/feature-spec.md` — slash-команда `/feature-spec` (pattern как spec.md, run-pipeline.md)
|
||
- `.opencode/skills/feature-spec/SKILL.md` — скилл с:
|
||
- SDD-шаблон (7 секций, совпадает с create-issue validation)
|
||
- Инструкции Q&A: агент задает вопросы списком, не гадает
|
||
- Decision criteria: когда feature-spec нужен (2+ компонента, бизнес-правила, diff >400 строк), когда нет (1 файл — прямой чат)
|
||
- Handoff: план в чате → юзер говорит "создай issue" → issue скилл → /run-pipeline
|
||
|
||
## Почему
|
||
|
||
При реализации фич через прямой чат агент часто не получает результат с первого промпта — нет зафиксированных контрактов, граничных случаев, out-of-scope. Feature-spec — лёгкий скилл: Q&A по SDD-шаблону → план в чате → issue через `issue` скилл → `/run-pipeline`. Не требует oracle-скрипта, файлов спеки или создания issues.
|
||
|
||
## Pending
|
||
|
||
- Обновить AGENTS.md если нужно упомянуть feature-spec в pipeline или workflow
|
||
- Добавить feature-spec в README репозитория (если применимо)
|
||
- Мониторить использование: действительно ли Q&A улучшает результаты с первого промпта
|
||
|
||
## Watch out
|
||
|
||
- Feature-spec НЕ создаёт issues — только планирует. Юзер должен сказать "создай issue"
|
||
- Feature-spec НЕ запускает /run-pipeline — юзер делает это сам
|
||
- SDD-шаблон должен совпадать с 7 секциями create-issue validation (PR #169)
|
||
- Если фича простая (1 файл) — агент должен сказать что спека не нужна
|
||
- Нет oracle-скрипта — это Q&A, не детерминистичный процесс как /spec
|