仓库说明是 coding agent 的第一层护栏

要让 agent 可靠交付,先把隐性团队约定变成可读取的项目协议。

适合谁:开发团队、开源项目、AI 工具运营

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

工作流哪里变了

Codex 的 AGENTS.md 指南把项目约定、测试命令、工程规则和完成标准写成 agent 可读取的仓库上下文。

把 repo layout、运行命令、测试命令、PR 期待、禁止动作和 done definition 写进仓库说明。

工具名不是结果

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

先核对权限和失败

  • 补一版 AGENTS.md:包括安装、测试、lint、提交规则、危险操作和验收标准
  • 先选一个低风险任务或工具入口验证权限、日志、失败处理和人工接管,不要直接接入关键生产流程

哪些还要核验

没有仓库说明时,agent 会从代码里猜团队习惯,容易漏掉测试和审查边界。原始来源保留在文末,方便把公告事实、证据和本站判断分开看。

AGENTS.md仓库说明开发工作流