← 所有指南

AI 寫程式記憶實用指南

哪些事情值得請 AI 記住?

只有在脈絡夠長久、不容易重新查到,而且之後可能再次派上用場時,才值得存成私人記憶。短期任務狀態和能從目前來源檔案查到的事實,留在原本的工具。秘密不要存;涉及他人隱私的內容也要審慎挑選。

維護者:Cairn

文件更新日期:

內容為選用指南,範例僅供說明。

先做一次「下次還用得到嗎」的判斷

存之前先問:這段對話結束後我還會需要它嗎?之後能不能很快查回來?記住它會不會改變我未來的決定?長期偏好,或仍在執行中的決策理由,常常值得留下;今天早上的測試結果通常不必。

筆記盡量寫得明確。交代適用於誰或哪裡、決策日期,以及什麼來源或條件會讓你再次核對。來源收據提供檢查線索,不能替內容背書。

把有用的事和短暫狀態分開

  1. 1. 長期個人偏好

    例如「大幅重構前,先跑範圍明確的測試」可能對不同專案都有用。若希望它跟著帳號跨專案使用,就放在個人範圍;工作習慣改變時也要更新。

  2. 2. 有日期和理由的決策

    只有決策理由之後仍會派上用場時,才值得記下來。附上日期、適用專案、負責人或來源,以及需要重新檢查的條件。正式的專案決策紀錄仍應留在持續維護的地方。

  3. 3. 短期任務狀態

    分支名稱、剛失敗的測試或下一個要跑的指令,通常很快就過期。把它寫在負責追蹤任務的 issue、草稿或工作紀錄。

  4. 4. 程式可以讀取的事實

    版本、可執行的指令、功能旗標和目前設定,應留在 package.json、CI 設定或應用程式組態等維護中的檔案。需要時查看檔案,不要依賴一份過期的記憶。

  5. 5. 秘密和他人的私人資料

    不要儲存密碼、API key、存取權杖或私人對話逐字內容。沒有明確授權和用途時,不要記下他人的機密或可識別資訊;即使可以使用,也只保留必要的最少內容。

寫成之後能再次核對的記憶

一筆記憶以一項說法、適用範圍和理由為主,不要寫成很廣泛的個人側寫。決策要說清楚何時做成,以及依據哪份資料、或碰到什麼情況要重新檢查。個人偏好則要交代適用所有專案,還是只有某個情境。

Cairn 的 recall_memory 結果可能附來源收據,forget_memory 則需要使用查詢回傳的確切識別碼。召回可能漏掉相符記憶。收據只能說明筆記從哪裡來,不代表內容現在還正確;採取行動前先核對維護中的來源。

已開啟自動擷取時

Claude Code 外掛完成設定後,可能會自動擷取對話文字。你貼進對話的一般文字也可能包含在內,例如終端輸出或檔案內容;憑證遮蔽只能盡力辨識。不要把秘密或整段私人對話放進已連線的聊天室,再期待記憶功能會自動挑掉。

使用前先知道

  • 召回是搜尋,可能漏掉相關記憶。來源收據不能驗證目前的程式碼或團隊決策。
  • 寫在筆記裡的日期和重新檢查條件能幫助判斷脈絡,不代表決策目前仍有效。
  • 記憶只屬於擁有者。它不能取代共享且經過審閱的專案紀錄,也不會因此自動成為團隊知識卡。

來源與產品說明