Retour d'expérience & Accumulation de spécifications
Automatise la collecte, l'analyse et la documentation des apprentissages après implémentation. Orchestre multi-agents pour mettre à jour les spécifications et proposer des améliorations.
name: dev:feedback description: | 実装完了後、学んだことをDESIGN.mdに蓄積。リファクタリング/スキル・ルールの自己改善も提案。 ストーリー駆動開発の終点。 「フィードバック」「/dev:feedback」で起動。
Trigger: フィードバック, 学習事項蓄積, /dev:feedback, feedback, design update allowed-tools:
- Read
- Write
- Edit
- Bash
- Glob
- Grep
- Task
- AskUserQuestion
フィードバック → 仕様書蓄積(dev:feedback)
エージェント委譲ルール
⚠️ 分析・更新・提案は必ずTaskエージェントに委譲する。自分で実行しない。
呼び出しパターン(全ステップ共通):
agentContent = Read(".claude/skills/dev/feedback/agents/{agent}.md")
Task({ prompt: agentContent + 追加コンテキスト, subagent_type: {type}, model: {指定モデル} })
| Phase | agent | model | type | 追加コンテキスト | |-------|-------|-------|------|-----------------| | 1 | analyze-changes.md | sonnet | general-purpose | git diff, feature-slug, story-slug | | 2a | update-design.md | sonnet | general-purpose | Phase 1のJSON + feature-slug | | 2c | (code-simplifier) | opus | code-simplifier | docs/features/DESIGN.mdのパス | | 3 | propose-improvement.md | opus | general-purpose | Phase 1-2の結果 + feature-slug | | 4 | evaluate-tests.md | haiku | general-purpose | テストファイル一覧 |
出力先
| ファイル | Phase |
|----------|-------|
| docs/features/{feature-slug}/DESIGN.md | 2a |
| docs/features/DESIGN.md | 2b |
| docs/features/{feature-slug}/IMPROVEMENTS.md | 3(該当時) |
★ 実行手順(必ずこの順序で実行)
Phase 1: 変更内容の収集 → 分析JSON
- → エージェント委譲(analyze-changes.md / sonnet)
- 分析結果をJSONとして保持
ゲート: 分析JSONが得られなければ次に進まない。
Phase 2a: 機能DESIGN.md更新
- → エージェント委譲(update-design.md / sonnet)
docs/features/{feature-slug}/DESIGN.mdに追記・保存
ゲート: 機能DESIGN.mdが更新されなければ次に進まない。
Phase 2b: 総合DESIGN.md更新 ★必須★
- Phase 2aの内容から、プロジェクト全体に影響する設計判断を抽出
docs/features/DESIGN.mdに追記(Edit)- 判断基準は references/update-format.md を参照
ゲート: 総合DESIGN.mdが更新されなければ次に進まない。
Phase 2c: 総合DESIGNの整理
- → エージェント委譲(code-simplifier / opus)
- 整理観点は references/update-format.md の「総合DESIGN.md整理の観点」を参照
Phase 3: 改善提案ドキュメント化(該当時)
- → エージェント委譲(propose-improvement.md / opus)
docs/features/{feature-slug}/IMPROVEMENTS.mdに保存
Phase 4: テスト資産の整理(TDDタスクがあった場合)
- → エージェント委譲(evaluate-tests.md / haiku)— 保持/簡素化/削除を分類
- AskUserQuestion でテスト整理方針を確認(整理する/すべて保持/スキップ)
- 選択に応じてテストの簡素化・削除を実行
完了条件
- [ ] 変更内容が分析された(Phase 1)
- [ ] 機能DESIGN.mdが更新された(Phase 2a)
- [ ] 総合DESIGN.mdが更新された(Phase 2b) ★必須★
- [ ] 総合DESIGNが整理された(Phase 2c)
- [ ] 改善提案が作成された(該当時)(Phase 3)
- [ ] テスト資産が整理された(TDD時)(Phase 4)
参照
- agents/: analyze-changes.md, update-design.md, propose-improvement.md, evaluate-tests.md
- references/: design-template.md, update-format.md, improvement-patterns.md
Skills similaires
Expert Next.js App Router
Un skill qui transforme Claude en expert Next.js App Router.
Générateur de README
Crée des README.md professionnels et complets pour vos projets.
Rédacteur de Documentation API
Génère de la documentation API complète au format OpenAPI/Swagger.