直近の会話ログから「繰り返し発生している指示・訂正・手戻り・許可プロンプト」を抽出し、設定ファイルへの恒久的な改善として提案・適用する。目的は同じフィードバックを二度と繰り返させないこと。

手順

1. 実行履歴 (config.json) の読み込み

プロジェクト(git root)の .agents/skills-config/retro/config.json を読む。runs 配列の最後の timestamp が前回実行時刻で、これが分析範囲の起点になる。ファイルが無い・runs が空なら初回実行として直近 7 日を起点にする。

2. スコープの確認

AskUserQuestion (multiSelect) で改善対象を確認する: CLAUDE.md (グローバル/プロジェクト) / .claude/skills / .claude/rules / .claude/settings*。あわせて分析範囲 (前回実行以降で良いか) も確認する。分析中に対象外だが価値のある改善点を見つけた場合は、適用はせずレポートの「その他の提案」に含める。

3. 分析ソースの収集

(a) /insights の facets キャッシュ (一次ソース)

Claude Code 組み込みの /insights はセッションごとの分析結果を ~/.claude/usage-data/facets/*.json (ファイル名 = セッション ID) にキャッシュする。各 JSON の friction_counts / friction_detail / outcome / user_satisfaction_counts / brief_summary は改善シグナルの宝庫なので最優先で使う。