AI写的说明文档，正在拖你的编程助手后腿

苏黎世联邦理工学院刚发了一项研究，结论让很多人意外。

他们测试了 AGENTS.md、CLAUDE.md 这类”上下文文件”——就是你放在代码仓库里，告诉 AI 助手”这个项目是怎么运作的”那种文件。

结论很反直觉：让 AI 自动生成这类文件，会让编程助手变笨。

具体数据： AI 生成的上下文文件：性能下降 0.5%~2%，推理成本却多出 20% 人类亲手写的：性能提升约 4%

为什么会这样？
研究发现，AI 生成的文档有个致命问题：它把 README 里已经有的内容重复了一遍。

AI 助手看到这些重复信息后，确实会更”认真”——运行更多测试、搜索更多文件、遍历更多代码。但”更努力”不等于”更聪明”。它只是多走了弯路。

有趣的是，研究团队做了个实验：把仓库里原有的文档先删掉，再让 AI 生成上下文文件。这时候 AI 生成的文件反而提升了 2.7%，比人类写的还好。
原因很清楚：没了已有文档，AI 只能写那些”别处找不到的信息”，而这正是上下文文件真正应该做的事。

人类写的文档为什么有效？因为人类知道什么是”不明显的”。

为什么选了 uv 而不是 pip、CI 里某个奇怪的设置、某个函数命名背后的历史原因。这些信息 AI 从代码里读不出来，但放进上下文文件，AI 就能直接用上。

写 AGENTS.md 的原则只有一条：写差距，不写概述。

✅ 你的工具栈与默认不同的地方
✅ 测试配置里不明显的细节
✅ 从代码本身看不出来的约定
❌ README 里已经有的内容
❌ 显而易见的项目结构说明

还有一个现实问题：每加一个上下文文件，推理成本平均多 20%。对高频使用 AI 编程工具的团队来说，这笔钱加起来不小。

所以，少即是多。AGENTS.md 写得越精准，AI 才越有用。

原文链接：https://nlp.elvissaravia.com/p/does-agentsmd-actually-help-coding

#AGENTS.MD研究揭秘
#AI编程助手效率
#技术分享与交流