# 怎么写一份不帮倒忙的 AGENTS.md？

> 原标题：What makes a good AGENTS.md?

- 来源：Ben's Bites
- 发布时间：2026-03-19T14:02:51.000Z
- AX AI 日报：https://ai-daily.ax0x.ai/items/46
- 原文：https://www.bensbites.com/p/what-makes-a-good-agentsmd

## 摘要

AGENTS.md 是给 AI 助手预载的指令文件，但别把它写成项目地图。有研究指出，塞进技术栈、关键文件路径这类信息反而会拉低表现，还让 token 消耗多出 20%——这些东西模型自己翻翻代码就能搞清楚。更好的做法是只保留你的行为偏好和纠偏提示，比如“生成网页前先用内置浏览器测一下再给我链接”、“把计划文件统一写到 ~/项目名/plan/ 里”。文...

## 推荐理由

这篇讲的是怎么把 AGENTS.md 写小、写干净。核心判断很明确：别往里面塞技术栈和文件地图，只保留行为偏好，否则效果会变差，成本还能多出 20%。这个 20% 的数字来自一项研究，但正文没披露研究名称和实验设置，所以我会先打个折来看。可执行的部分挺实在，比如把 AGENTS.md 和 CLAUDE.md 做 symlink、用条件块区分简单网页和复杂应用、按文件夹动态加载，都是能直接抄作业的做法。对经常跟 coding agent 打交道的人来说，这比“多写点上下文”的直觉有用得多，本质是把常驻指令压到最小，减少每次调用的无效消耗。信息缺口在于...

## 锐评

这篇文章的核心判断很直接：AGENTS.md 不是给模型画地图，而是定规矩。它引了一项研究，说把技术栈、关键文件路径这类信息写进去，不仅没用，还会让表现变差、token 消耗多出 20%。这个结论挺反直觉，但文章没披露研究名称和实验设置，所以可信度得先打个折。

作者给出的替代方案是只保留行为偏好和纠偏提示，比如“生成网页前先用内置浏览器测一下再给我链接”、“把计划文件统一写到某个目录”。还提了几个实用技巧：用条件块区分简单网页和复杂应用的指令，把 AGENTS.md 软链接到 CLAUDE.md 避免维护两份，以及利用文件夹级别的动态加载让不同目录有不同规则。

整体思路是让持久化指令尽量短，把探索代码库的事还给模型自己。但文章没给出“少写”的边界在哪，也没说偏好写多细才刚好够用。如果你打算照着改自己的 AGENTS.md，最好先拿一两个项目试，对比一下改前后的 token 消耗和输出质量，别一上来就全删光。