Skills Guide

Feedback & Accumulation de Spécifications

VérifiéPrudence

Après chaque implémentation, ce skill analyse les modifications (git diff), met à jour le DESIGN.md fonctionnel et global, propose des améliorations et réorganise les tests si nécessaire. Il est déclenché par les mots-clés « feedback » ou « /dev:feedback » et s'exécute en quatre phases via des sous-agents spécialisés. Utile pour clore un cycle de développement en consolidant les décisions de conception et en suggérant des refactorings.

Spar Skills Guide Bot
DeveloppementAvancé
9002/06/2026
Claude Code
#feedback#design-documentation#learning#story-driven-development

Recommandé pour

Développeur backendClaude CodeRevue de codeDéveloppeur frontendDéveloppeur fullstackRefactoring

Notre avis

Cette compétence analyse les modifications de code après une implémentation, met à jour les documents de conception (DESIGN.md) avec les apprentissages, et propose des améliorations.

Points forts

  • Automatise la mise à jour des documents de conception avec des informations précises issues du code réel.
  • Encourage l'amélioration continue en documentant les leçons apprises et en suggérant des refactorisations.
  • S'intègre dans un workflow de développement piloté par les récits utilisateur.

Limites

  • Nécessite une structure de projet bien définie avec des fichiers DESIGN.md et des dossiers de fonctionnalités.
  • Peut produire des mises à jour redondantes si les changements sont minimes.
  • Dépend de la clarté des messages de commit et des différences pour une analyse précise.
Quand l'utiliser

Utilisez cette compétence à la fin de chaque fonctionnalité ou histoire utilisateur pour capturer les apprentissages et maintenir la documentation à jour.

Quand l'éviter

Ne l'utilisez pas pour des corrections de bugs mineurs ou des modifications qui n'altèrent pas la conception globale du système.

Analyse de sécurité

Prudence
Score qualité85/100

The skill orchestrates a development feedback loop using subagents, which involves reading and writing documentation, running git diff, and executing commands via Bash. While the primary purpose is legitimate, the use of Bash and file modifications poses a moderate risk that requires trust in the subagent instructions.

Points d'attention
  • •Uses Bash and file editing tools, which could potentially be misused if the agent instructions are compromised or not reviewed.

Exemples

Post-feature feedback and design update
After finishing the user authentication feature, run feedback to update DESIGN.md with what we learned.
Accumulate learning and improve code
I just completed the payment integration story. Execute dev:feedback to accumulate learnings, update the design document, and suggest any refactoring.
Evaluate tests and clean up
Finished implementing the search functionality. Use feedback to analyze changes, update the design docs, and evaluate whether the TDD tests need simplification or removal.

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

  1. → エージェント委譲（analyze-changes.md / sonnet）
  2. 分析結果をJSONとして保持

ゲート: 分析JSONが得られなければ次に進まない。

Phase 2a: 機能DESIGN.md更新

  1. → エージェント委譲（update-design.md / sonnet）
  2. docs/features/{feature-slug}/DESIGN.md に追記・保存

ゲート: 機能DESIGN.mdが更新されなければ次に進まない。

Phase 2b: 総合DESIGN.md更新 ★必須★

  1. Phase 2aの内容から、プロジェクト全体に影響する設計判断を抽出
  2. docs/features/DESIGN.md に追記（Edit）
  3. 判断基準は references/update-format.md を参照

ゲート: 総合DESIGN.mdが更新されなければ次に進まない。

Phase 2c: 総合DESIGNの整理

  1. → エージェント委譲（code-simplifier / opus）
  2. 整理観点は references/update-format.md の「総合DESIGN.md整理の観点」を参照

Phase 3: 改善提案ドキュメント化（該当時）

  1. → エージェント委譲（propose-improvement.md / opus）
  2. docs/features/{feature-slug}/IMPROVEMENTS.md に保存

Phase 4: テスト資産の整理（TDDタスクがあった場合）

  1. → エージェント委譲（evaluate-tests.md / haiku）— 保持/簡素化/削除を分類
  2. AskUserQuestion でテスト整理方針を確認（整理する/すべて保持/スキップ）
  3. 選択に応じてテストの簡素化・削除を実行

完了条件

  • [ ] 変更内容が分析された（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

Developpement

Un skill qui transforme Claude en expert Next.js App Router.

Claude CodeCursoradvanced
890
234
2,846
Admin

Générateur de README

Developpement

Crée des README.md professionnels et complets pour vos projets.

claudeCursorWindsurfbeginner
259
72
821
Admin

Rédacteur de Documentation API

Developpement

Génère de la documentation API complète au format OpenAPI/Swagger.

claudeCursorWindsurfintermediate
156
44
682
Admin