🔥 别再让 AI 一键生成 AGENTS.md 了，可能又贵又没用。

ETH Zurich 的研究团队实测了 Codex、Claude Code、Qwen Code 等多个 Coding Agent。

结果很反常识：

AI 自动生成的上下文文件，让推理成本平均增加 20%～23%，任务成功率反而下降了 0.5%～2%。

原因不是 AGENTS.md 本身没用。

而是 AI 很喜欢生成一份“大而全”的项目说明：目录结构、技术栈、代码规范、通用建议……很多内容 README 和代码里本来就有。

Agent 不仅要重复读取，还会因此搜索更多文件、执行更多步骤、运行更多测试，却不一定更接近正确答案。

真正有用的 AGENTS.md，只需要保留四类信息：

1. 无法从代码发现的硬约束
2. 准确可执行的构建和测试命令
3. 禁止修改的边界
4. 真实踩过的特殊坑

已经写得很长的，直接扔给 Codex：

「审计当前仓库全部 AGENTS.md、CLAUDE.md 及同类持久上下文文件。删除可从代码、README 或目录结构直接发现的信息，以及重复说明、通用建议和一次性任务背景；只保留不可推断的硬约束、准确的构建测试命令、禁止边界和已验证的特殊陷阱。不得遗漏独有规则。修改前备份并列出删除依据，最后报告优化前后字符数及可能风险。」

AGENTS.md 不是项目百科。写得越满，Agent 可能绕得越远。

#Codex #ClaudeCode #Agent #AGENTSmd #AI编程