session-reflection-analysis

Session Reflection Analysis 技能專為使用 Claude Code 進行高效開發的工程師所設計。透過編程方式處理會話歷史，此工具能協助您識別浪費資源的重複模式，例如重複讀取檔案、錯誤的路徑探索，或可自動化的手動步驟。它是一個元分析 (meta-analysis) 工具，透過改進文件、自定義斜線命令及優化工作習慣，協助您長期提升 AI 的效能。

• 自動根據當前目錄定位儲存在 ~/.claude/projects/ 中的特定專案會話檔案。

• 使用 jq 生成高度壓縮的 JSONL 摘要，在保留用戶意圖、工具呼叫與結果大小等重要上下文的同時，將 Token 消耗降至最低。

• 部署一個「Explore」子代理程式對摘要檔案進行啟發式分析，尋找 Token 浪費、重複錯誤或缺失自動化等效率低下指標。

• 生成結構化的 Markdown 反思文件，提供可直接複製使用的專案改進方案。

• 依優先級對調查結果進行分類，並引用您的實際聊天記錄作為具體範例以佐證每項建議。

• 請務必使用提供的 jq 腳本來產生摘要；切勿直接讀取原始會話檔案，以免超過 Token 限制。

• 產出內容僅供建議；請仔細審閱建議的改進措施，並手動套用至您的 CLAUDE.md、.claude/skills 或 .claude/commands/ 目錄中。

• 針對常見效率問題：識別您是否重複讀取檔案、未能驗證假設，或錯失了更新文件的機會。

• 此工具最適合在長工作階段結束時使用，或當您感覺代理程式效能下降時使用。它並非用於即時程式碼生成，而是為了在開發生命週期中實現持續的流程改進。