# 怎么写一份不帮倒忙的 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% token，只保留行为偏好和纠偏提示更有效。

## 锐评

AGENTS.md 里塞技术栈和文件路径会拉低表现，这个我信。模型翻代码本来就比读你手写的项目地图准，你写的那份还可能过期，每次调用都白烧 token，多 20% 不奇怪。

所以这东西该写的是模型猜不到的东西，比如生成网页前先自己用浏览器点一遍、计划文件统一丢到某个目录。这类偏好写进去才值钱，项目结构让它自己看。那个 20% 的研究没给名字，先当参考，但方向我认。
