session-reflection-analysis

session-reflection-analysis 技能是為使用 Claude Code 的開發人員設計的自我剖析工具。透過處理儲存在 ~/.claude/projects/ 中的本地 JSONL 會話日誌，此技能可識別重複出現的效率低下模式，例如冗餘的檔案讀取、錯誤的工具排序或上下文遺失。它專為希望在保持高開發速度的同時，將 Token 使用量控制在預算內的工程師而設計。此技能不再需要手動解析日誌，而是利用 jq 生成用戶請求、工具執行和系統回應的精簡摘要，然後由專門的子代理程式進行分析，提供可操作的結構化回饋。

• 自動將目前工作目錄對應至相關的 Claude Code 專案日誌。

• 使用高效的 jq 過濾器將會話歷史壓縮達 98%，在保留關鍵上下文的同時剔除無用資訊。

• 啟動 Explore 子代理程式以偵測諸如浪費 Token、重複錯誤、缺少自動化以及基於假設的錯誤等模式。

• 產生包含優先級改進建議、程式碼片段和預期影響指標的結構化 Markdown 反思文件。

• 透過建議改進措施而非直接執行，提供安全的人工審核過程。

• 若要觸發此技能，請詢問會話執行情況。

• 確保系統已安裝 jq (brew install jq 或 apt install jq)。

• 此技能需要存取 ~/.claude/projects/，並將分析輸出至 /tmp/session-summary.jsonl。

• 使用產生的建議來更新 CLAUDE.md、在 .claude/skills/ 中建立自訂 bash 腳本，或定義新的斜線指令以防止未來發生效率低下問題。

• 在執行之前務必審核建議的變更，以確保它們符合專案的具體編碼標準和架構需求。

• 輸出包含每項建議的詳細成本效益分析，有助於優先處理高影響力的文件更新或自動化任務。