Instructions／AGENTS.md：哪些規則值得長期保存？

把長期有效、能改變 AI 行為且可驗證的專案規則寫進 AGENTS.md；一次性成果、臨時偏好與過期資訊留在當次任務。

值得長期保存的規則，必須會重複出現、跨多次任務仍成立、讓新加入的人看得懂，而且可以檢查是否做到。一次性需求、暫時狀態、秘密與尚未確認的偏好，不要放進 instructions 或 AGENTS.md。

如果你每次都要提醒 Codex「先讀 README」「不要改既有 URL」「完成後跑測試」，這些規則可能值得保存。可是把今天的錯誤訊息、臨時活動日期和某次草稿要求一起塞進去，長期規則很快就會變成雜物堆。

OpenAI 把 AGENTS.md 形容成給 agent 使用的開放格式 README，會自動載入脈絡，可記錄 repository 結構、執行方式、測試指令、慣例、禁止事項與完成定義。OpenAI：Codex best practices ChatGPT Project 也能設定只在該專案生效的 instructions。OpenAI：Projects in ChatGPT

兩者不是相同技術，但有一個共同問題：寫進去的內容會影響後續很多任務，所以更要節制。

先把邊界說清楚：OpenAI 官方文件說明 AGENTS.md 與 Project instructions 的用途；下面「重複、穩定、可理解、可驗證」四個條件，是我用來判斷規則是否值得長期保存的教學整理，不是 OpenAI 官方評分表。

第一個條件：這條規則真的會重複嗎？

「本週五前交第一版」只對這次任務成立；「所有公開文章先完成來源查核」則可能持續有效。

先觀察兩三次工作。如果你不斷貼上同一句提醒，或反覆修正同一類錯誤，才把它列為候選。不要因為某次失敗，就立刻永久增加十條防呆規則。

第二個條件：過一段時間仍會成立嗎？

規則應描述穩定的工作方法，不是今天的狀態。

不適合：

目前最新檔案是 draft-final-3.md。
今天 API 暫時不能用。
這次先不要處理圖片。

比較適合：

正式版本入口記錄在 README.md；不要從檔名中的 final 判斷版本。
外部服務不可用時，回報阻擋，不得自行改用付費服務。
圖片工作只有在需求明確包含圖片時才啟動。

前者很快過期；後者說明遇到同類情況時要怎麼做。

第三個條件：不了解歷史的人也看得懂嗎？

「照上次方式處理」「Aaron 說過不能改那個」不是完整規則。寫清楚範圍、行為與原因：

既有公開文章 URL 不得重新命名，因為外部連結與搜尋索引依賴現有 canonical。
若需求涉及 URL 變更，停止並請求明確批准。

好的長期規則不要求 AI 讀完整段聊天，才能理解「那個」指什麼。

第四個條件：能不能檢查是否做到？

「寫得更好」「保持專業」「注意品質」無法驗證。改成具體行為：

修改完成後執行指定測試；若無法執行，回報未驗證項目與原因。
外部事實附原始來源與查閱日期；作者判斷使用第一人稱清楚區分。

完成後能回答「測試有沒有跑」「來源在哪裡」，規則才真正能工作。

哪些內容不該長期保存？

秘密不應因為「每次都需要」就寫進規則檔。長期需要憑證時，應使用產品支援的秘密管理或環境設定，規則只說明去哪裡取得與不得輸出的邊界。

用四欄寫出一條可維護規則

規則名稱：
適用範圍：什麼資料夾、專案或任務？
要求行為：遇到什麼情況要做什麼？
驗證方式：怎樣知道有做到？
維護者與更新條件：誰確認？什麼變化發生時重查？

例如：

規則名稱：保護已發布 URL
適用範圍：所有文章與課程內容修改
要求行為：不得自行變更既有 canonical；若需求涉及變更先停止並請求批准
驗證方式：修改前後比對發布 Registry
維護者與更新條件：內容負責人；只有正式 migration 決策可更新

練習：從重複提醒中選三條

回看最近三次 AI 工作，列出你重複說過的要求。只有同時通過四個條件的內容，才寫進長期工作規則草稿。

完成後再刪一次：如果移除某條不會影響日後行為，那條可能只是說明，不是規則。規則越多，衝突與過期的機會也越多。

下一步要處理規則與材料都會遇到的問題：時間一久，舊決定和新版本可能互相衝突。AI 的工作記憶也有限，所以需要一份不依賴聊天長度的脈絡與版本紀錄。

參考資料