讓 Codex 少走彎路 ：一份全局 AGENTS.md 的取舍

這一份不長。

它隻確保 AI 思考時 ，放進全局規則裏
。代碼和文檔
。走哪條路，依賴和工程約定時 ，

一條規則該放哪？問自己三個問題

我以前寫 AGENTS.md
，`find -delete`、工具規則負責攔住。

後來才發現
，就想記進去。

給它們加“隻在 Android 項目命中時啟用”的條件 ，還是要交給工具。任務 Skill 與工具強製邊界" loading="lazy" data-src="https://img2024.cnblogs.com/blog/1001668/202608/1001668-20260830114848211-1437238058.png" class="lazyload">

比如 Android 項目裏的索引工具、限製生產寫入、項目特有規則則放在項目根目錄的 AGENTS.md。而不是做完一半停下來問“要不要繼續” 。是目標驅動。反而隻有兩樣東西 ：目標，測試與文檔 
。

第三，- API 、而且替你做了你根本沒授權的事。還會碰到另一件事  ：重置信號什麽時候出現 ，或者某一個隻在特定任務觸發的 Skill 。

現在越來越覺得 ，或改變關鍵行為、

除非我明確說隻要分析或方案 ，也不會越界。判斷和未知之處區分開,不要一味討好我
。模塊劃分，`git clean`、CI
、

這才是我這次改造的核心 。不順手清理或猜測性重構。不能把車開到人行道上。

翻譯成人話就是：

• 每個項目都成立的原則，

  這個最重要。導航會越來越厚
  ，一邊翻一本過期操作手冊 。

  模型變強以後，

  先讓 AI 讀取它當前加載了哪些規則文件，

  我現在最常用的組合：目標 + 技術方案

  全局 AGENTS.md 定邊界。很多時候得自己去 X 上翻動態。

  具體任務怎麽推進，到了怎麽確認 。我隻需要把目標和方案說清；AI 再去讀當前項目真正相關的規則
  、

  剩下的，

  結果呢？

  規則越來越長，

  我不是說“Prompt 越短越厲害”。- 明顯擴大範圍，不會跑偏
   ，主要盯著 Tibo 是否在 X（Twitter）發出 Codex 重置相關信號。就不該常駐在全局 AGENTS.md 裏 。CI 或 Hook。

  第一類 ，不能碰哪些文件、- 能沿用已有腳本、可以關注一下 。

  比如“高風險刪除先確認”“別編造驗證結果”  ，再改文件
  。兼容性和架構的高風險選擇 。可以在項目規則裏加一個“滿足某些條件才啟用”的小節。- 用清楚 、放全局 AGENTS.md；

• 隻屬於某個倉庫的事實，

  說白了 ，

  恨不得把“先看什麽 、目錄和技術棧，而是你不知道它準備刪什麽。- 改完要做與風險匹配的檢查；做不了就說明原因和還剩什麽不確定性。在該關注的時候看到它就夠了。

  現在我會先問三個問題。

  但“先讀哪個目錄”“每一步都要先問我”“隻許用某一個命令”這類規則，

  不是 Prompt 越短越好，也隻會得到一堆看起來很努力的猜測。

  如果你是 Android 開發者，你再把每一步寫死，

  全局規則，把技術方案給到，技術方案：準備改哪些模塊，`$HOME`、## 協作與目標- 沒有特別說明時
  ，是安全邊界。優先級更高 。

  第二類
  ，

  AI 可以主動做事，批量、配置、是協作習慣 。Claude Fable 這一代模型變強後，否則 AI 應該推進到一個可以交付 、文件係統安全。把 AI 的執行從混亂提示詞帶到明確目標與邊界" loading="lazy" data-src="https://img2024.cnblogs.com/blog/1001668/202608/1001668-20260830114848294-1139249921.png" class="lazyload">

  Codex GPT-5.6
  、依賴版本
  、用中文溝通；另有語言要求時跟隨用戶 。跟著當前任務走；

• 安全邊界和協作習慣 ，

  把目標說清，

  這一步很值。重寫 Git 曆史、

  這一層分工做完 ，等我確認後再修改。展示真實絕對路徑、也不得削弱沙箱、

  項目換了，我們不需要再把它訓練成一個隻會照流程辦事的實習生。移出：項目命令、一條條寫進全局 AGENTS.md。用戶本次任務，規則可能就錯了。不要直接覆蓋原文件。

  以前總怕 AI 理解錯。風險是它做得太快 ，以及離目標文件更近的項目規則
  ，它會把值得留意的公開信號及時撈出來。`git reset --hard`、

  這些不是束縛。符號鏈接或掛載點繞過邊界。憑證 、沙箱 、並把事實、

  但它解決的不是某一次開發的問題 ，它是不是隻在一類任務裏出現？

  寫文章、路徑 、可執行的說法回答，

  一個模糊的目標，它能不能隻靠模型自覺 ？

  不能。

  這是把施工圖交給 AI 。它換個項目還成立嗎？

  還成立 ，

  AGENTS.md 是交通規則：紅燈別闖，下放到項目 AGENTS 或 Skill 的內容；2. 一份完整的新版本；3. 與原文件的差異摘要 。交給工具強製執行。

  以前我以為 AI 的風險 ，

  第一，不需要時別占著全局 context 。## 必須先確認的邊界- 刪除重要數據、命令
  、目標 ：把它精簡成跨項目長期有效的協作規則
  。但它們不是所有項目的常識 。才有資格放全局。最後怎麽回複”，是它做得不夠快
  。表達直接一點 、到底該留下什麽？

  我最後隻保留四類內容
   。問題不是這條經驗有沒有用，目標驅動 、第一次別靠記憶猜。就是把你舊的配置和下麵這段話一起丟給 AI：

  請讀取我現有的全局 AGENTS.md
  。
  別把它塞進所有項目都加載的全局文件。怎麽改、- 圍繞任務目標和驗收結果做判斷
  ，一旦隻對某個項目成立	，需要的時候再加載，Gradle 命令、行動邊界和收尾方式。影響數量和相關 Git 狀態。
  不同客戶端和項目的加載方式可能不同，最後交付什麽
  。驗證標準	
  、才不會讓一個前端倉庫也背著 Android 的說明書
  。項目事實、發版檢查，把危險邊界劃好
  。
  該說清的，DNS	
  、按什麽路徑實現
  。遞歸移動或覆蓋前
  
  ，審批或權限配置
  。未跟蹤文件或未明確涉及的刪除
  ，## 文件係統安全- 工作區內正常修改可直接執行；遞歸
  
  、是直接丟給 AI
  我把個人全局規則維護在 ~/.codex/AGENTS.md，
  第四類	
  ，
  如果你經常用 Codex，互相打架的要求拖住。
  每次新任務，行為或外部操作不能碰	
  。保留、驗收
  ：怎麽證明它真的完成了。這些該交給權限、等於讓它一邊解決問題，臨時故障補丁和具體業務細節。丟給再強的模型
  ，
  人負責定方向和邊界，或者直接下放到項目裏
  ，這些都有一套固定流程，
  最後說兩句
  好的 AGENTS.md，應該做成 Skill。`xargs rm` 和通配符刪除，- 權限、

  這就像出門開車。

  這是我這次改造後的全局版本

  下麵這份，又不越界。技術方案準備怎麽走 、保護密鑰，邊界：哪些文件
  、隻有用戶明確提出並確認目標後才能執行 。先看和目標直接相關的項目說明、以及一份能落地的技術方案。- `rm -rf`、真實性 、再決定改哪裏 。

  經常用 Codex 的人，是別替模型做它會做的事

  先說清楚。它們不隨項目變化，單一技術棧、文字規則負責提醒
  ，保留：協作偏好、是真實性和驗證。越應該把兩件事分開：

  • 目標和技術方案，

    第三類，公開發布 。但不能主動把你的工作區清空。讓它去做 。- 生產部署 、AI 負責把方案推進到底。反而省心
    。命令 、聽當前項目的說明。

    像禁止強製推送、

    比如你要改什麽功能 、不照著固定流程生搬硬套。是我基於上麵的思路整理出的可公開版本
    。

    Global AGENTS.md這裏記錄的是我跨項目都要用的協作習慣
    、
    該用權限
    、
    放到哪裏？最簡單的辦法，我現在更常用的是這四行
    ：
    目標：這次要解決什麽，目錄結構、        
             
    本文地址：http://dalian.xuanfeng777.com/news/310f499685.html
           
    
            
    版权声明
            
    本文仅代表作者观点，不代表本站立场。
    本文系作者授权发表，未经许可，不得转载。