AGENTS.md 是团队交付口径,不只是提示词文件

coding agent 的实际效果,很大一部分来自仓库是否把上下文和验收口径写清楚。

适合谁:工程团队、开源项目、AI agent 服务商

OpenAI 开发者工具界面展示项目上下文、工具连接和检查结果
图片来源:OpenAI Apps SDK。

工作流哪里变了

AGENTS.md 让仓库可以给 agent 提供项目结构、命令、测试和约束,适合把团队默认做法写成可复查规则。

把 repo layout、安装命令、测试命令、代码风格、禁止动作和完成定义写进仓库说明,减少每次委托任务时的口头解释。

工具名不是结果

这条信号的价值在于改变团队如何交付、复核或恢复流程,而不是再增加一个工具名。

先核对权限和失败

  • 为一个真实仓库补一版 AGENTS.md,并要求每个 agent PR 引用它的测试和完成定义
  • 先选一个低风险任务或工具入口验证权限、日志、失败处理和人工接管,不要直接接入关键生产流程

哪些还要核验

没有仓库说明时,agent 容易按通用假设改代码,review 成本会转嫁给团队。原始来源保留在文末,方便把公告事实、证据和本站判断分开看。

AGENTS.md仓库说明验收标准