同一個 AI agent，放進兩個專案，表現可能判若兩人。
在 A 專案裡，它東翻西找、亂猜規則，像是無頭蒼蠅；
到了 B 專案，它卻像一名資深夥伴：知道遵守工作規則，也清楚哪些檔案碰不得。
差別往往只在一件事：B 專案裡，有一份 AGENTS.md。
AGENTS.md 只是一份markdown檔案，卻會影響 AI 如何理解專案與做出判斷，把它稱為 AI agent 的靈魂，並不誇張。
AGENTS.md 到底在寫什麼
一句話說明：AGENTS.md 是寫給 AI agent 看的說明書。
它通常放在專案根目錄，內容包括專案架構、建置與測試指令、程式碼風格，以及需要人工確認的安全規則。
而這跟一般 README 有什麼差別？在於服務對象不同，README 幫助人類理解專案；
AGENTS.md 則要交代Agent能直接執行的工作規則：先讀哪些資料、遵守哪些流程與格式、哪些檔案或資料不能動，以及交付前如何檢查結果等等。
生態現況：誰在用AGENTS.md ?
AGENTS.md 已被大量的開源專案採用，支援工具橫跨 OpenAI Codex、Google Jules、VS Code、GitHub Copilot 與 Cursor。這些工具平常在模型能力、介面和工作流程上各自競爭，但是他們遵守共一份檔案的規範
這種默契它傳遞的訊息其實很簡單：AGENTS.md 不是哪一家想推的規格，而是大家都需要、也都用得上的共通語言。
對開發者來說,這代表你今天寫下的這份檔案,不會因為換了工具就白費——它是一個可以安心押注的長期選擇。
Claude也有自己的AGENTS.md，但是他用自己的特規，取名為CLAUDE.md，但是功能和用法是一樣的
一份有用的 AGENTS.md，應該怎麼寫
AGENTS.md 沒有必填欄位。但一份好的文件，至少該讓 agents 搞清楚三件事：專案概覽、建置與測試指令、團隊慣例。
這三件是基本盤：知道自己在做什麼專案、怎麼驗證改動、該照什麼規矩寫——agent 才能真正上手，而不是每一步都要你補充說明。
通常我還會加上第四件——哪些操作要先問人。這一項標準是把 agent 從「能跑」帶到「可信任」的關鍵。
AGENTS.md 放在哪裡？
一般專案就把 AGENTS.md 放在專案根目錄，讓 agent 一進來就先能讀到共同規則。
而且AGENTS.md也不一定要自己建立然後放進資料夾。現在的 ChatGPT，也能在「設定 → 個人化 → 自訂指令」裡，寫下希望它長期遵守的回應方式，例如你的角色、偏好的語氣、輸出格式與需要先確認的界線。
效果很像替自己的 ChatGPT 寫一份個人版 AGENTS.md：少一點每次重複交代，多一點穩定的工作方式。
AGENTS.md & 設定自訂指令差別在於範圍。ChatGPT 的自訂指令屬於使用者層級，適合放長期偏好；
AGENTS.md 屬於專案層級，適合放會跟著專案資料夾、文件或團隊一起變動的規則。
前者告訴 AI「你該怎麼和我合作」，後者告訴 AI「你進到這個專案裡面應該怎麼做事」。
有沒有 AGENTS.md，差別在哪裡
想像同一個 agent 接到「整理一份要交給客戶的提案」的任務。
沒有 AGENTS.md 時，它得自己猜哪一份簡報才是最新版、品牌語氣該怎麼拿捏，也不知道哪些客戶資料不能外傳。
有 AGENTS.md 時，這些猜測可以在一開始被消除。agent 知道該先讀哪份資料、沿用什麼格式、避開哪些內容，交付前又該由誰覆核。
AGENTS.md 真正有價值的地方，就是讓 agent 知道自己身處哪裡，有什麼資料可以參考，要遵守什麼規則
AGENT.md 賦予 AI agents 靈魂
AGENTS.md 只是一份 Markdown，卻替原本只會執行指令的系統補上了專案脈絡：你現在在哪裡、這裡的規矩是什麼，以及哪些事要先問人。
沒有這份脈絡，agent 依然能動手，只是每一步都得重新猜測。
規則被寫下來之後，它才像一名真正加入團隊的協作者。
發表迴響