今天遇到的問題

昨天談過的決定，今天 AI 卻又問一次。也可能是我們的討論很多，但最後決定沒有寫進檔案。聊天紀錄和可維護的專案資訊不是同一件事。

一個核心概念：讓重要狀態可以重建

上下文有容量限制；不需要把所有聊天永遠留在同一 session。把目標、已完成、證據、待辦和阻塞保存下來，新對話就能重新讀取。

CLAUDE.md 與自動記憶的來源、用途不同；/memory 用來檢視或管理相關設定，/context 協助查看上下文。實際畫面依版本核對。Claude Code 記憶文件

實作：寫一份明天能接手的紀錄

請讀 project-goal.md、CLAUDE.md 和 docs/project-map.md。
對照實際檔案後，建立 docs/handoff.md：
目前目標、已完成與證據、尚未實作、已知限制、下一個最小任務。
不要寫入 token、完整聊天紀錄或私人資訊。
沒跑過的命令不能標成已通過。
今天只整理文件，不新增應用程式功能。

儲存後結束 session，再開新 session：

請讀 CLAUDE.md 和 docs/handoff.md。
用五句話說明目前專案狀態，指出下一步。
有矛盾時以實際檔案證據為準，先提出差異，不直接重做。

如果選單有 /compact，可以先看其說明再試；摘要是減少上下文的工具，不是保證所有重要細節都會留下。

一個失敗案例

handoff 寫「報告已完成」，但只有規格文件。新 session 可能接著修改不存在的程式。將交接改成「已完成報告規格，程式未實作」，並附文件位置。

當日驗收

• [ ] 新 session 不需讀完整舊對話，就能指出下一個任務。
• [ ] 交接內容的每個完成項都有檔案或測試證據。
• [ ] 舊決定與現況不同時，有明確修正。

實測後補：新 session 說對和說錯的各一項，以及你如何修正文件。

下一天預告

明天開始用 skills，先了解目前版本已經提供什麼。