AGENTS.md

product · 首次出现 2026-05-22 · 最近出现 2026-11-15 · 累计提及 70

综述

AGENTS.md 是一种放在代码仓库根目录的说明文件,用自然语言告诉 AI 编码智能体该项目的结构、约定和注意事项,目前已成为 Claude Code、Codex 等主流智能体工具普遍支持的配置标准。随着 coding agent 从演示走向日常生产工具,AGENTS.md 的写法本身正在演变成一门独立的工程实践。

AGENTS.md 的近期进展

  • Claude Code 新版本支持 AGENTS.md 文件:Claude Code 正式加入对 AGENTS.md 的原生支持,意味着此前以 CLAUDE.md 为中心的工作流开始向开放标准靠拢,多智能体工具共享同一份项目说明成为可能。
  • OpenAI:GPT-6 需优化 Skill 和 AGENTS.md 配置:OpenAI 在模型发布指引中明确提到,新模型需要针对 Skill 与 AGENTS.md 配置进行优化,说明这一文件已上升为智能体产品体验的一环,而不仅是用户侧的民间约定。
  • 三份 Agents.md 实测对比:耗时、token 用量与成本差异明显:有开发者对三份不同写法的 Agents.md 做了对比实验,结果显示在耗时、token 消耗和实际成本上差异明显——AGENTS.md 不再是“写了就行”,其质量直接影响使用成本。
  • Geoffrey Huntley:用 pre-commit hook 约束编码智能体的写法:在提示词之外,社区开始结合 pre-commit hook 等工程手段对智能体行为做硬性约束,形成“软指令 + 硬约束”的组合打法。
  • 当前焦点与观察点

    当前讨论集中在两个方向。一是指令工程本身:有实践者提出用 AGENTS.md 加入“防跑偏”指令来抑制 coding agent 过度纠结的问题,也有针对 AI Agent 测试怎么写才不跑偏的具体规则总结,核心矛盾在于指令太少约束不足、太多则消耗 token 且容易被忽略。二是信任与验证:Grok Bot 团队的 Lauren 提出信任 Agent 工作成果的四层倒金字塔框架,反映出团队在采纳智能体产出时,需要比“看 diff”更系统化的评估方式。

    总体来看,AGENTS.md 正从可选的提示词附件转变为智能体开发的基础设施。值得观察的点包括:各家工具对这一标准的兼容程度是否会进一步统一,社区是否会沉淀出可复用的模板与度量方法,以及随着模型能力增强,说明文件的角色会更多偏向事实描述还是行为约束。

    相关报道

    10 条在档