GPT WORLD / INDEPENDENT CODEX FIELD MANUAL 來源檢視 · 2026-07-31

回顧期號 / CODEX

把 repository 真相寫進 AGENTS.md

Durable guidance 應說明 architecture boundary、command、convention 與 verification,但不能取代當前 task。

01 / DECIDE

架構決策

當 contributor 與 agent 經常需要相同 repository-specific instruction 時採用。

Durable guidance 應說明 architecture boundary、command、convention 與 verification,但不能取代當前 task。 先把 input、output、state 與 side effect 畫成一條可觀察路徑,再決定 把 repository 真相寫進 AGENTS.md 要放在哪一層。

02 / BUILD

三步實作

  1. 01

    框定合約

    先寫下 caller、資料分類、成功條件、timeout、取消與 ownership。當 contributor 與 agent 經常需要相同 repository-specific instruction 時採用。

  2. 02

    建立單一路徑

    只實作一條 end-to-end path,保留 request correlation、typed state 與可逆 failure handling。Durable guidance 應說明 architecture boundary、command、convention 與 verification,但不能取代當前 task。

  3. 03

    證明結果

    把驗收寫成可重跑的 fixture、contract test 或 browser test。新加入者不需 private context,也能執行文件中的 check 並得到相同 repository 解讀。

03 / BOUND

Production 邊界

Instruction 要 scoped、executable、current 且不含 secret;nested file 只應特化其 subtree。

04 / PROVE

驗收證據

新加入者不需 private context,也能執行文件中的 check 並得到相同 repository 解讀。

SOURCE / HTTP

可重現來源探針

curl -fsSI 'https://learn.chatgpt.com/docs/agent-configuration/agents-md' | sed -n '1,5p'