結論先說
- 模型「走捷徑」本質上是在目標未封口時優先追求命令返回綠燈。如果提示詞只說「修好報錯讓測試通過」,未明確禁止改動測試和靜態檢查配置,模型可能用刪除斷言或關閉規則來快速達成表面成功。
- 用
AGENTS.md把團隊底線固化在倉庫裏,每次會話自動生效。按官方文檔,Codex 會先讀取全局~/.codex/AGENTS.md,再從項目根目錄逐級向下拼接到當前目錄的AGENTS.md(存在AGENTS.override.md時同目錄優先覆蓋),整體合併預設上限為32 KiB(完整規則見 /guides/codex-agents-md-how-it-reads)。 - 寫護欄要寫「禁止動作 + 替代動作」,而不是空泛口號。把「代碼質素要高」改成「嚴禁刪除或
.skip已有測試;若確認為測試預期過期,必須先列出理由並暫停等待人工確認」。 AGENTS.md只是軟護欄,必須配合沙箱、審批模式與 Git 檢查形成硬閉環。高風險目錄與命令應交由沙箱審批把關(配置見 /guides/codex-permissions-sandbox),提交前用git diff --stat與/review二次核驗。- 團隊持續磨合規則與多輪代碼審查需關注套餐配額。若國內支付不便或需要更高並發與使用上限,可在本站自助選擇 ChatGPT Plus 充值 或 ChatGPT Pro 充值,多人研發團隊也可對接 ChatGPT Business 團隊定製。

圖:本站結合 OpenAI Codex 官方文檔:AGENTS.md 與工程實踐整理的示意圖
本文根據 OpenAI Codex 官方文檔《Custom instructions with AGENTS.md》《Advanced configuration》《Codex CLI》整理,資料核對於 2026-11-19。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。
適用於誰
- 遇到 Codex 為了讓測試變綠而直接刪減用例、註釋斷言或硬編碼特判入參的開發者;
- 苦惱於模型順手添加
@ts-ignore、eslint-disable、重排無關文件代碼導致 PR 差異難以審查的工程師; - 希望在團隊倉庫根目錄沉澱一份簡潔、可執行、不易被截斷的
AGENTS.md規範的研發負責人。
一、先弄清 Codex 怎麼讀 AGENTS.md,避免寫了不生效
很多開發者把上千行公司編碼規範直接粘進 AGENTS.md,結果模型依然我行我素,通常有兩個原因:一是文件放錯層級或被同目錄的 AGENTS.override.md 覆蓋;二是各級文件拼接總字節數超過官方預設上限 32 KiB(對應 config.toml 中的 project_doc_max_bytes),導致末尾關鍵約束被截斷。
此外,動態記憶(Memories)與 AGENTS.md 的職責不同:個人偏好可以放記憶,但涉及代碼安全、測試保護與提交底線的硬規矩,務必顯式寫進受版本控制的倉庫 AGENTS.md(兩者對比見 /guides/codex-memories-how-to-use-vs-agents-md)。本站建議將根目錄 AGENTS.md 控制在 80 到 150 行以內,把最關鍵的 5 條禁令置頂。
二、5 條可直接複製的 AGENTS.md 硬約束護欄寫法
下面這份模板針對「刪測試、硬編碼繞校驗、關檢查、改無關文件、虛報結果」五類高頻痛點編寫,可直接放入項目根目錄的 AGENTS.md 中按技術棧微調:
markdown
# Repository Guardrails for Codex
## 1. 測試保護護欄(嚴禁偽造綠燈)
- 嚴禁刪除、註釋、`.skip`、`.only` 或放寬任何已有單元測試、集成測試與 E2E 斷言。
- 嚴禁針對測試用例裏的特定輸入值編寫硬編碼 `if` 分支來湊通過。
- 如果判斷某個舊測試確實已與新需求衝突,必須先停止修改測試文件,列出衝突點與建議,等待人工明確批准後再改。
## 2. 類型與靜態檢查護欄(嚴禁掩蓋報錯)
- 嚴禁新增 `@ts-ignore`、`@ts-expect-error`、`as any`、`eslint-disable`、`# type: ignore` 或 `# noqa` 來繞過編譯器和 Linter 報錯。
- 嚴禁修改 `tsconfig.json`、`eslint.config.*`、`pyproject.toml` 中的嚴格校驗級別來消除告警。
## 3. 最小改動範圍護欄(禁止順手改無關文件)
- 僅修改與當前任務直接相關的文件和代碼行。
- 嚴禁對未涉及的舊文件執行全文件格式化、重排 import、重命名公共導出符號或「順手重構」。
- 交付前先自查 `git diff --stat`,若出現無關文件改動必須主動還原。
## 4. 依賴、遷移與敏感文件護欄
- 未經明確授權,禁止安裝或升級第三方依賴、修改鎖文件、改動數據庫遷移歷史腳本,以及讀寫 `.env`、密鑰或鑑權配置。
- 涉及破壞性命令(如刪除目錄、強制重置 Git 歷史、清空數據庫表)一律先說明影響並等待確認。
## 5. 真實執行與如實彙報護欄
- 每次修改完成後,必須實際運行對應校驗命令(如 `npm run typecheck`、`npm test`、`ruff check`)。
- 若因沙箱限制或環境缺失無法運行驗證命令,必須在答覆開頭明確寫明「未運行校驗及原因」,嚴禁在未執行時聲稱測試已通過。
訂閱與帳號準備提示:在大型倉庫裏執行多輪規則校驗、單測迴歸與/review覆核會穩定佔用模型額度(額度規則見 /guides/codex-usage-limits)。重度編碼用戶可在本站升級 ChatGPT Pro 5x iOS 可覆蓋檔 或 ChatGPT Pro 5x 信用卡不可覆蓋檔;新帳號首次開通 Codex 若遇到手機驗證卡住,可參考 Codex 註冊手機驗證服務。
三、光靠 AGENTS.md 不夠:疊加三道硬驗收防線
AGENTS.md 屬於提示詞級約束,在超長對話上下文衰減時仍存在偶發越界可能。本站建議再疊加三道不依賴模型自覺性的工程閘門:
- 開啟合理審批與沙箱模式:日常開發保持在工作區可寫但敏感命令需審批的模式,禁止無腦常開全放行權限。
- 用只讀命令與
/review做交付前審 diff:每次任務結束執行git diff --name-status查看是否觸碰了tests/、配置文件或鎖文件,再運行/review專門檢查是否存在硬編碼或弱化斷言(詳見 /guides/codex-code-review)。 - 在 Git 鉤子與 CI 中卡死禁用註釋:在 CI 流水線裏用規則檢查新增 diff 是否引入了
eslint-disable、@ts-ignore或.skip(,一旦命中直接拒絕合併。

圖:本站結合工程治理經驗整理的檢查清單示意圖
常見問題
問:為什麼我改了 AGENTS.md,正在進行的 Codex 命令行會話裏還是沒按新規矩執行?
答:按官方文檔說明,Codex 是在啟動任務或新建會話時一次性讀取並構建指令鏈的,中途修改 AGENTS.md 不會自動熱更新到舊會話。改完規則後應退出當前會話並重新啟動,或者新開一條獨立對話驗證。
問:子目錄前端和後端規範不一樣,全寫進根目錄 AGENTS.md 會不會衝突或太長?
答:不會。Codex 支持從倉庫根逐級向下讀取目錄中的 AGENTS.md,後面的目錄規則可補充或細化前面的要求。建議把通用 5 條護欄放在倉庫根,把前端 Tailwind 或後端 SQL 專屬細則拆分到 web/AGENTS.md 與 server/AGENTS.md,既清晰又不容易觸發 32 KiB 上限。
問:國內缺少外幣信用卡,或者研發團隊想統一採購並開票報銷,怎麼開通 ChatGPT / Codex 訂閱?
答:可在站內 AI 會員充值總覽 直接選購 ChatGPT Plus、ChatGPT Plus 自助卡密 或高配額 ChatGPT Pro,支持支付寶、微信支付與 AlipayHK,提供卡密自助兌換(無需交出帳號密碼)與客服協助,並支持開具增值稅發票;多人研發團隊也可諮詢 Business 團隊席位定製。實時價格以頁面顯示為準,售後遵循掉訂閱按剩餘天數折退、封號不在質保範圍的規則。
相關教學
- Codex 怎麼讀 AGENTS.md:全局和項目的讀取順序與 32 KiB 上限排查
- Codex 動態記憶(Memories)和 AGENTS.md 的區別與用法
- Codex 權限與沙箱設定:審批模式與安全邊界
- Codex 代碼審查(codex review)怎麼用
參考資料
- OpenAI Codex 官方文檔:Custom instructions with AGENTS.md — https://learn.chatgpt.com/docs/agent-configuration/agents-md
- OpenAI Codex 官方文檔:Advanced configuration — https://learn.chatgpt.com/docs/config-file/config-advanced
- OpenAI Codex 官方文檔:Codex CLI — https://learn.chatgpt.com/docs/codex/cli
- OpenAI Codex 官方文檔:Command line options — https://learn.chatgpt.com/docs/developer-commands
0 條評論
還沒有評論,來搶沙發~