把仓库约定写进 AGENTS.md

团队使用 Codex 时，最先需要统一的不是提示词，而是仓库约定。哪些命令能验证改动、哪些目录是生成产物、哪些文件不能随意重排、发布前需要检查什么，这些内容都应该变成持久说明，而不是散落在聊天记录里。

`AGENTS.md` 适合放长期有效的工程规则。它不应该写成产品愿景，也不应该塞进每个任务的临时需求。一个好用的结构通常包括：项目概览、常用命令、测试策略、代码风格、数据和安全边界、部署方式、评审偏好。

规则越具体，越容易执行。例如“保持代码质量”不如“修改 TypeScript 后运行 `npm test` 和 `npm run build`”；“注意样式”不如“移动端必须无横向滚动，按钮文字不得溢出”。Codex 更擅长遵守可观察的约束。

团队还要定期清理这些约定。过期命令、已经废弃的目录、没人执行的检查会制造噪音。建议把 `AGENTS.md` 当作工程资产维护：每次发布流程变化、测试命令变化、部署方式变化，都同步更新。

当约定写清楚后，提示可以变短。你可以直接说“按仓库约定实现这个改动，并给出验证结果”。这会让团队协作从依赖个人经验，转向依赖共同维护的工程上下文。