CODEXGUIDE / 进阶专题

AGENTS.md 项目协作规则

用 AGENTS.md 给 Codex 提供可检查、可继承的项目上下文,让修改范围和验收标准保持一致。

写清楚四件事

一份有效的 AGENTS.md 至少说明项目用途、常用命令、目录边界和完成标准。规则要具体到可以执行或验证,而不是只写风格口号。

  • 允许修改哪些目录,禁止碰哪些文件。
  • 安装、开发、测试和构建命令。
  • 提交前必须运行的检查。
  • 生成文件、迁移和生产操作的审批要求。

先验证再扩大范围

可以先按完成一个可回滚的真实任务验证规则是否足够,再把稳定做法沉淀回 AGENTS.md。