AGENTS.md 是一种放在代码仓库根目录的说明文件,用自然语言告诉 AI 编码智能体该项目的结构、约定和注意事项,目前已成为 Claude Code、Codex 等主流智能体工具普遍支持的配置标准。随着 coding agent 从演示走向日常生产工具,AGENTS.md 的写法本身正在演变成一门独立的工程实践。
AGENTS.md 的近期进展
当前焦点与观察点
当前讨论集中在两个方向。一是指令工程本身:有实践者提出用 AGENTS.md 加入“防跑偏”指令来抑制 coding agent 过度纠结的问题,也有针对 AI Agent 测试怎么写才不跑偏的具体规则总结,核心矛盾在于指令太少约束不足、太多则消耗 token 且容易被忽略。二是信任与验证:Grok Bot 团队的 Lauren 提出信任 Agent 工作成果的四层倒金字塔框架,反映出团队在采纳智能体产出时,需要比“看 diff”更系统化的评估方式。
总体来看,AGENTS.md 正从可选的提示词附件转变为智能体开发的基础设施。值得观察的点包括:各家工具对这一标准的兼容程度是否会进一步统一,社区是否会沉淀出可复用的模板与度量方法,以及随着模型能力增强,说明文件的角色会更多偏向事实描述还是行为约束。