opencode-config/docs/handoff/pr-172-feature-spec-skill.md at feat/telegram-send-tool

feat(feature-spec): add SDD-style Q&A skill for feature planning (#172 )

* 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>

2026-07-31 19:58:12 +03:00

2.3 KiB

Raw Permalink Blame History

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

2.3 KiB Raw Permalink Blame History Unescape Escape