Episode Details

研究發現自動生成的 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