Kaizen Improvement
.planning/kaizen/ 内の分析結果を、実践可能な改善項目(フック、エージェントパッチ、スキル改良、CLAUDE.md更新、自動化スクリプト)に変換します。
前提条件: .planning/kaizen/ に分析結果が存在すること(transcript-analysis スキルによって生成)。
改善の種類
以下の各カテゴリには、委任用のテンプレートがあります。
- フック生成 — PreToolUse(拒否/リダイレクト)、SubagentStart(コンテキスト注入)、Stop(品質ゲート)
- エージェントプロンプト改良 — @subagent-refactorer によるエージェントシステムプロンプトへの精密な修正
- スキルパッチ — /plugin-creator:skill-creator によるスキルへの知識追加
- CLAUDE.md更新 — プロジェクト全体の行動ルール
- スクリプト自動化 — 繰り返し行われる手動ワークフローのスクリプトまたはスキルへの置き換え
詳細なテンプレートと例については、Improvement Templates を参照してください。
自律的改善ループ(ARL)ナレッジベース(レイヤー3の実装詳細、前提条件、研究統合)については、ARL Knowledge を参照してください。
ワークフロー
flowchart TD
Start([分析結果を読む]) --> Parse[頻度と証拠に基づいてアンチパターンを抽出]
Parse --> Score[頻度 × 影響度でスコアリング]
Score --> Top[上位の結果を選択]
Top --> Type{改善の種類は?}
Type -->|ツールの繰り返し誤用| Hook[フック生成 — 拒否/リダイレクト]
Type -->|エージェントの動作問題| Agent[エージェントパッチ指示セット生成]
Type -->|知識不足| Skill[スキルパッチ指示セット生成]
Type -->|プロジェクト全体の問題| Claude[CLAUDE.md追加案生成]
Type -->|手動ワークフロー| Script[自動化提案生成]
Hook --> Output[.planning/kaizen/improvements/ に書き出し]
Agent --> Output
Skill --> Output
Claude --> Output
Script --> Output
Output --> Install{--install フラグ?}
Install -->|はい| Apply[フックを設定に書き込み、パッチを適用]
Install -->|いいえ| Draft[レビュー用の提案として残す]
フック生成
分析結果を読み → フック設定とオプションのスクリプトを生成します。各アンチパターンタイプに対応するパターン、ガイドライン、例については、Hook Patterns を参照してください。
委任プロトコル
改善項目は、専門エージェントへの指示セットであり、直接編集ではありません。結果重視の委任に従ってください:
- 問題を証拠(セッションID、ツール呼び出し、頻度)とともに記述する
- 望ましい結果を述べる
- 専門エージェントが実装方法を決定できるようにする
- 委任プロンプトに特定のコード変更を指定しない
出力モード
ドラフトモード(デフォルト)
すべての提案をマークダウンファイルとして .planning/kaizen/improvements/ に書き出します。各ファイルには以下が含まれます:
- 証拠付きの結果サマリー
- 提案された改善
- 適切な専門エージェントへの委任プロンプト
- 優先度スコア
インストールモード(--install フラグ)
フックのみ — .claude/settings.json または hooks/hooks.json に直接書き込みます。その他の改善タイプは常に委任プロンプトを生成します(直接編集はありません)。
優先度スコアリング
以下の基準で改善項目をランク付けします:
- 頻度 × 影響度 — セッション全体での発生回数 × 1回あたりのコスト
- 自動化の可能性 — フック > スクリプト > ドキュメント
- 影響範囲 — プロジェクト全体 > 単一エージェント > 単一セッション
- 実装コスト — フック(数分)< CLAUDE.md(数分)< スキル(数時間)< エージェント(数日)