Agent skill
dev:feedback
実装完了後、学んだことをDESIGN.mdに蓄積。スキル/ルールの自己改善も提案。 PR作成・Worktreeクリーンアップまで実行。ストーリー駆動開発の終点。 「フィードバック」「/dev:feedback」で起動。 Trigger: フィードバック, 学習事項蓄積, /dev:feedback, feedback, design update
Install this agent skill to your Project
npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/feedback-ryryo-dot-claude-dev-68cc77a5
SKILL.md
フィードバック → 仕様書蓄積(dev:feedback)
概要
実装完了後、学んだことをシステム仕様書(DESIGN.md)に蓄積。 繰り返しパターンはスキル/ルール化を提案し、meta-skill-creatorと連携。
入力
- feature-slug, story-slug
- 実装済みコード(git diff)
- output/フォルダのレポート(あれば)
出力
docs/features/{feature-slug}/DESIGN.mdに追記docs/features/DESIGN.md(総合設計)にも反映- スキル/ルール化の提案
ワークフロー
Phase 1: 変更内容の収集
→ agents/analyze-changes.md [sonnet]
→ 変更ファイル・学習事項を抽出
↓
Phase 2: 仕様書更新
→ agents/update-design.md [opus]
→ DESIGN.mdに設計判断を追記
↓
Phase 3: パターン検出
→ agents/detect-patterns.md [haiku]
→ 繰り返しパターンを検出
↓
Phase 4: 改善提案
→ agents/propose-improvement.md [opus]
→ スキル化/ルール化を提案
→ ユーザー承認後、meta-skill-creatorを呼び出し
↓
Phase 5: PR作成・Worktreeクリーンアップ
→ PR作成(gh pr create)
→ マージ後、Worktree削除
Phase 1: 変更内容の収集
git diff --stat HEAD~5
git log --oneline -10
Task({
description: "変更分析",
prompt: `git diffから以下を抽出してください:
1. 変更されたファイル一覧
2. 追加された機能
3. 設計判断(なぜこの構造にしたか)
4. 技術的な発見
5. 注意点・ハマりどころ
出力形式: JSON`,
subagent_type: "general-purpose",
model: "sonnet"
})
→ 詳細: agents/analyze-changes.md
Phase 2: 仕様書更新
既存のDESIGN.mdがあれば追記、なければ新規作成。
Task({
description: "仕様書更新",
prompt: `DESIGN.mdを更新してください。
追記内容:
- 設計判断(なぜこの構造にしたか)
- 技術的な発見
- 注意点・ハマりどころ
フォーマット: references/update-format.md を参照`,
subagent_type: "general-purpose",
model: "opus"
})
→ 詳細: agents/update-design.md → テンプレート: references/design-template.md
更新先
| ファイル | スコープ | 更新内容 |
|---|---|---|
docs/features/{feature-slug}/DESIGN.md |
機能単位 | ストーリーからの学習事項 |
docs/features/DESIGN.md |
プロジェクト全体 | 重要な設計判断のみ |
更新フォーマット
## 更新履歴
### 2024-01-21: {story-slug}
**設計判断**:
- JWTではなくセッションベース認証を採用(理由: ...)
- バリデーションはZodを使用
**学んだこと**:
- React Hook Formとの連携でのポイント
- エラーハンドリングのパターン
**注意点**:
- 〇〇の場合は△△に注意
Phase 3: パターン検出
Task({
description: "パターン検出",
prompt: `実装履歴から繰り返しパターンを検出してください。
検出対象:
- 3回以上使用したパターン
- 同じ構造のコード
- 共通の設計判断
出力形式: JSON(patterns配列)`,
subagent_type: "general-purpose",
model: "haiku"
})
→ 詳細: agents/detect-patterns.md
Phase 4: 改善提案
繰り返しパターンを検出し、スキル/ルール化を提案。
Task({
description: "改善提案",
prompt: `検出されたパターンをスキル/ルール化する提案を生成してください。
提案形式:
- ルール化候補: .claude/rules/ に保存
- スキル化候補: .claude/skills/ に保存
各提案に以下を含める:
- パターン名
- 適用条件
- 期待される効果`,
subagent_type: "general-purpose",
model: "opus"
})
→ 詳細: agents/propose-improvement.md → パターン基準: references/improvement-patterns.md
提案フォーマット
💡 改善提案を検出しました
1. **ルール化候補**:
- Zodバリデーションパターンを3回使用
→ `.claude/rules/languages/typescript/validation.md` として保存?
2. **スキル化候補**:
- 認証フロー実装で同じ手順を実行
→ `.claude/skills/dev/auth-setup/SKILL.md` として抽出?
ユーザー確認
AskUserQuestion({
questions: [{
question: "これらのパターンをルール/スキルとして保存しますか?",
header: "自己改善",
options: [
{ label: "保存する", description: "meta-skill-creatorでルール/スキルを作成" },
{ label: "今回はスキップ", description: "保存しない" }
],
multiSelect: false
}]
})
「保存する」を選択された場合:
- meta-skill-creatorを呼び出してスキル/ルールを作成
フィードバック記録
meta-skill-creatorの機構を活用:
| ファイル | 用途 | 更新タイミング |
|---|---|---|
| LOGS.md | 実行記録 | 毎回実行後 |
| EVALS.json | メトリクス | 毎回実行後 |
| patterns.md | 成功/失敗パターン | パターン発見時 |
→ 詳細: references/feedback-loop.md
Phase 5: PR作成・Worktreeクリーンアップ
5.1 PR作成確認
AskUserQuestion({
questions: [{
question: "PRを作成しますか?",
header: "PR作成",
options: [
{ label: "PRを作成", description: "gh pr create でPRを作成" },
{ label: "後で手動で作成", description: "今回はスキップ" }
],
multiSelect: false
}]
})
5.2 PR作成(選択時)
# 変更をプッシュ
git push -u origin HEAD
# PRを作成
gh pr create --title "{story-slug}" --body "$(cat <<'EOF'
## Summary
- {実装内容のサマリー}
## Changes
- {変更ファイル一覧}
## Test plan
- [ ] テストが通ること
- [ ] 動作確認
🤖 Generated with Claude Code
EOF
)"
5.3 Worktreeクリーンアップ
PRがマージされた後のクリーンアップ手順を案内:
📋 **PR作成完了**
PRがマージされたら、以下のコマンドでWorktreeを削除してください:
\`\`\`bash
# メインブランチに戻る
cd /path/to/main/repo
# Worktreeを削除
git worktree remove ../{branch-name}
# ブランチを削除(オプション)
git branch -d {branch-name}
\`\`\`
自動クリーンアップ(オプション):
AskUserQuestion({
questions: [{
question: "PRマージ後にWorktreeを自動削除しますか?",
header: "クリーンアップ",
options: [
{ label: "自動削除", description: "マージ確認後にWorktreeとブランチを削除" },
{ label: "手動で削除", description: "削除コマンドを表示のみ" }
],
multiSelect: false
}]
})
完了条件
- 変更内容が分析された
- DESIGN.mdが更新された
- パターン検出が実行された
- 改善提案が表示された(該当あれば)
- PR作成が完了した(または手動作成を選択)
- Worktreeクリーンアップ手順を案内した
関連スキル
- dev:story-to-tasks: 次のストーリーのタスク生成
- meta-skill-creator: スキル/ルール作成(改善提案時に連携)
参照
- DESIGN.mdは「実装の記録」として育てていく
- 仕様書を最初に作るのではなく、実装後のフィードバックで徐々に蓄積・更新
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
agent-ops-spec
Manage specification documents in .agent/specs/. Use when user provides requirements, acceptance criteria, or feature descriptions that need to be tracked and validated against implementation.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-testing
Test strategy, execution, and coverage analysis. Use when designing tests, running test suites, or analyzing test results beyond baseline checks.
agent-ops-state
Maintain .agent state files. Use at session start, after meaningful steps, and before concluding: read/update constitution/memory/focus/issues/baseline consistently.
Didn't find tool you were looking for?