session-memory

session-memory 技能是一種先進的機制，旨在解決 Claude Code 在隔離執行工作階段之間遺失上下文的問題。透過在 .claude/memory/ 目錄中建立專用的持久化層，此技能確保專案決策、實作模式和任務歷史記錄在工作階段重新啟動後依然存在。它專為需要長期專案連續性，並希望維護架構選擇與開發工作流程單一事實來源 (SSOT) 的軟體開發人員與工程師所設計。

• 使用唯一的環境變數自動追蹤工作階段日誌，以實現審核能力與歷史追蹤。

• 為關鍵專案資料維護不同的檔案：session-log.md 用於記錄歷史，decisions.md 用於記錄決策理由，patterns.md 用於記錄可重複使用的編碼標準。

• 透過 context.json 支援基於 JSON 的專案上下文管理，儲存技術堆疊資訊、專案階段與元資料。

• 與 Agent Trace 日誌整合，允許代理程式在恢復執行時，重建檔案系統的近期狀態與過去的工具執行歷史。

• 實作分層記憶架構 (Layer 1-3)，區分全域工具使用模式與專案特定知識。

• 為 Claude Code 中的 --resume 工作流程提供無縫支援，促進複雜、多階段開發任務的還原。

• 當您需要在休息後恢復工作，或被詢問關於歷史記錄、專案狀態或過去技術決策時，請使用此技能。

• 確保重要的架構決策被移至 decisions.md (SSOT) 以防止知識損耗。

• 在啟動完整狀態還原之前，利用 /recap 指令快速審查當前工作階段的進度。

• 將高度變動的臨時資料排除在長期儲存之外，以保持儲存庫整潔。

• 使用版本控制時請謹慎：雖然決策與模式應在 Git 中共享，但工作階段日誌與上下文狀態通常應保持在本地。

• 請注意，敏感憑證或個人識別資訊 (PII) 絕不應提交至記憶體檔案中。