AI 寫程式記憶實用指南
哪些事情值得請 AI 記住?
只有在脈絡夠長久、不容易重新查到,而且之後可能再次派上用場時,才值得存成私人記憶。短期任務狀態和能從目前來源檔案查到的事實,留在原本的工具。秘密不要存;涉及他人隱私的內容也要審慎挑選。
先做一次「下次還用得到嗎」的判斷
存之前先問:這段對話結束後我還會需要它嗎?之後能不能很快查回來?記住它會不會改變我未來的決定?長期偏好,或仍在執行中的決策理由,常常值得留下;今天早上的測試結果通常不必。
筆記盡量寫得明確。交代適用於誰或哪裡、決策日期,以及什麼來源或條件會讓你再次核對。來源收據提供檢查線索,不能替內容背書。
把有用的事和短暫狀態分開
1. 長期個人偏好
例如「大幅重構前,先跑範圍明確的測試」可能對不同專案都有用。若希望它跟著帳號跨專案使用,就放在個人範圍;工作習慣改變時也要更新。
2. 有日期和理由的決策
只有決策理由之後仍會派上用場時,才值得記下來。附上日期、適用專案、負責人或來源,以及需要重新檢查的條件。正式的專案決策紀錄仍應留在持續維護的地方。
3. 短期任務狀態
分支名稱、剛失敗的測試或下一個要跑的指令,通常很快就過期。把它寫在負責追蹤任務的 issue、草稿或工作紀錄。
4. 程式可以讀取的事實
版本、可執行的指令、功能旗標和目前設定,應留在
package.json、CI 設定或應用程式組態等維護中的檔案。需要時查看檔案,不要依賴一份過期的記憶。5. 秘密和他人的私人資料
不要儲存密碼、API key、存取權杖或私人對話逐字內容。沒有明確授權和用途時,不要記下他人的機密或可識別資訊;即使可以使用,也只保留必要的最少內容。
寫成之後能再次核對的記憶
一筆記憶以一項說法、適用範圍和理由為主,不要寫成很廣泛的個人側寫。決策要說清楚何時做成,以及依據哪份資料、或碰到什麼情況要重新檢查。個人偏好則要交代適用所有專案,還是只有某個情境。
Cairn 的 recall_memory 結果可能附來源收據,forget_memory 則需要使用查詢回傳的確切識別碼。召回可能漏掉相符記憶。收據只能說明筆記從哪裡來,不代表內容現在還正確;採取行動前先核對維護中的來源。
已開啟自動擷取時
Claude Code 外掛完成設定後,可能會自動擷取對話文字。你貼進對話的一般文字也可能包含在內,例如終端輸出或檔案內容;憑證遮蔽只能盡力辨識。不要把秘密或整段私人對話放進已連線的聊天室,再期待記憶功能會自動挑掉。
使用前先知道
- 召回是搜尋,可能漏掉相關記憶。來源收據不能驗證目前的程式碼或團隊決策。
- 寫在筆記裡的日期和重新檢查條件能幫助判斷脈絡,不代表決策目前仍有效。
- 記憶只屬於擁有者。它不能取代共享且經過審閱的專案紀錄,也不會因此自動成為團隊知識卡。