retrospectivelisted
Install: claude install-skill takayoshitoyoda05/claude-ml-template
# レトロスペクティブ(自己改善)
/ml-pipeline の運用で溜まったフィードバックを分析し、テンプレートの改善案を提案する。
## フィードバックの蓄積(他のエージェントが行う)
以下のイベントが発生すると、.claude/improvements/feedback.md に自動追記される。
| イベント | 記録する内容 |
|----------|--------------|
| evaluator が NEEDS_REVISION | 差し戻し理由と該当ファイル |
| evaluator-standards が NEEDS_REVISION | 指摘内容と該当ファイル |
| ユーザーが計画を却下 | 却下の理由 |
各エントリの形式:
## YYYY-MM-DD [イベント種別]
- 原因/理由: ...
- 該当ファイル: ...
## 分析の進め方
1. .claude/improvements/feedback.md を読む。無ければ「フィードバックが
まだ溜まっていません」と報告して終了する。
2. 同じパターンの問題を集約する。
3. evaluator-standards の指摘傾向を分析する。feedback.md 内の
[evaluator-standards: NEEDS_REVISION] エントリの指摘内容を分類し、
同じ種類の指摘(例: 「ネストが深い」「型ヒント欠落」)が3回以上あれば、
generator.md のコーディングルールまたは .claude/rules/ の該当ルール
(python-style.md 等)への追記を改善案として提案する
(指摘される前に書かせる方向へ倒す)。
4. 会話履歴やフィードバックの中に、ユーザーがコードの好み
(「この書き方好き」「これ読みにくい」等)を口にした記録があれば、
その実例を .claude/rules/taste.md への追記として提案する。
5. 3回以上繰り返されているパターンを特定する。
6. 各パターンについて改善案を出す。
## 改善案の形式
### パターン: [問題の要約]
- 発生回数: N回
- 原因分析: なぜ繰り返されているか
- 改善案: どのファイルの何をどう変えるか
- 影響範囲: 他のエージェント・スキルへの影響
7. 改善案を .claude/improvements/patterns.md に保存する。
## improvement-reviewer との連携
分析が完了したら、ユーザーに2つの選択肢を提示する。
1. **自動適用**: 「@improvement-reviewer に審査・適用させて」
2. **手動適用**: ユーザー自身が判断して手で適用する。
どちら���選ぶかはユーザーに委ねる。自動的に improvement-reviewer を呼ばない。
## 重要なルール
- 1回しか起きていない問題は改善案にしない。3回以上のパターンだけを対象にする。
- 改善案を自動で適用しない。必ずユーザーの判断を経る。