01 详细解释
内容通常是构建命令、目录约定、测试方式、代码风格、以及「哪些目录别碰」。编码 Agent 进入仓库时会先读它,省得每次靠猜。
它和 README 的区别是读者:README 给人看,AGENTS.md 给 Agent 看,所以更偏可执行指令、少讲背景。不同工具对文件名有各自约定,但思路一致。
放在代码仓库里、写给 AI 编码助手看的项目说明书。
本词条最后核验 2026-11-21 · 由本站编辑整理,欢迎指正
内容通常是构建命令、目录约定、测试方式、代码风格、以及「哪些目录别碰」。编码 Agent 进入仓库时会先读它,省得每次靠猜。
它和 README 的区别是读者:README 给人看,AGENTS.md 给 Agent 看,所以更偏可执行指令、少讲背景。不同工具对文件名有各自约定,但思路一致。
文件里写「提交前必须跑 npm test,禁止直接改 dist/」,助手执行前会先读。
规则写成可验证的命令或路径,少写「请尽量」「最好」这类模糊表述。
工具怎么描述、上下文怎么管、出错怎么反思、权限怎么收,决定了 Agent 是能跑完流程还是第三步就开始乱调接口。
下面这些站点来自 AI 导航(nav.ppv9.com)的同一份工具清单,按本词条的相关度挑选。