AGENTS.md 到底有沒有用？研究出爐：寫太多反而讓結果更糟

研究發現自動生成的 AGENTS.md 反而降低 coding agent 成功率且增加 20% 成本。人寫版也只提升 4%。Agent 不是不聽話，是聽太多話。整理研究數據並告訴你該怎麼改寫。 ⭐ 文章深度讀：文章最後整理了該寫、該刪的具體清單 → https://heymaibao.com/agents-md-evaluation-research/ 📝 懶人包 ∙ LLM 自動生成的 AGENTS.md / CLAUDE.md (例如用 /init 指令) 反而降低 coding agent 的成功率，同時推理成本增加超過 20%。 ∙ 開發者手寫的 context file 效果也有限，平均只提升 4% 成功率，而且 agent 會忠實遵守裡面的每條指令。 ∙ 問題出在「過度規格化」：agent 花太多時間遵守不必要的指令，反而沒時間解決實際問題。 ∙ 這篇研究測的是「解 GitHub issue」的封閉任務，日常開發情境不同。但核心啟示一致：context file 只寫最低必要，別貪多。 📚 參考資料 Gloaguen et al., 2026. Evaluating AGENTS.md: Are Repository-Level Context Files Helpful for Coding Agents? → https://arxiv.org/abs/2602.11988