Kaizen 改善
將來自 .planning/kaizen/ 的分析結果轉化為可實作的改善措施 — 鉤子、代理修補、技能精煉、CLAUDE.md 更新以及自動化腳本。
先決條件： 必須存在 .planning/kaizen/ 中的分析結果（由 transcript-analysis 技能產生）。
改善類型
每種輸出類別都有對應的委派範本：
- 鉤子產生 — PreToolUse 拒絕/重新導向、SubagentStart 上下文注入、Stop 品質閘門
- 代理提示詞精煉 — 透過 @subagent-refactorer 對代理系統提示詞進行精準修正
- 技能修補 — 透過 /plugin-creator:skill-creator 為技能補充遺漏的知識
- CLAUDE.md 更新 — 專案層級的行為規則
- 腳本自動化 — 將重複的手動工作流程替換為腳本或技能
如需詳細範本與範例，請參閱 改善範本。
如需自主改進循環 (ARL) 知識庫 — 第 3 層實作細節、先決條件與研究綜合 — 請參閱 ARL 知識。
工作流程
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[保留為待審核的提案]
鉤子產生
讀取分析結果 → 產生鉤子設定與可選腳本。關於每種反模式類型對應的模式、指南與範例，請參閱 鉤子模式。
委派協議
改善項目是專門代理的指令集，而非直接編輯。遵循以成果為導向的委派原則：
- 描述問題並附上證據（會話 ID、工具呼叫、頻率）
- 說明期望的成果
- 讓專門代理決定實作方式
- 切勿在委派提示詞中指定特定的程式碼變更
輸出模式
草稿模式（預設）
將所有提案以 Markdown 檔案形式寫入 .planning/kaizen/improvements/。每個檔案包含：
- 附有證據的發現摘要
- 建議的改善
- 給適當專門代理的委派提示詞
- 優先級分數
安裝模式（--install 旗標）
僅適用於鉤子 — 直接寫入 .claude/settings.json 或 hooks/hooks.json。其他改善類型一律產生委派提示詞（絕不直接編輯）。
優先級評分
根據以下項目排序改善項目：
- 頻率 × 影響 — 跨會話的出現次數 × 每次發生的成本
- 自動化潛力 — 鉤子 > 腳本 > 文件
- 影響範圍 — 專案層級 > 單一代理 > 單一會話
- 實作成本 — 鉤子（分鐘）< CLAUDE.md（分鐘）< 技能（小時）< 代理（天）