Codex 执行
Codex 执行规则
Codex 修改手册、代码和配置时必须遵守的输入模板、执行原则和禁止事项。
执行原则
Codex 每次执行任务时必须遵守:
- 先阅读
AGENTS.md。 - 先理解任务,再修改文件。
- 优先修改最小范围。
- 不做用户没有要求的重构。
- 不删除已有内容,除非任务明确要求。
- 不改动权限、认证、部署配置,除非任务明确要求。
- 不引入新的依赖,除非说明理由。
- 不伪造测试结果。
- 修改完成后必须说明改了哪些文件。
- 涉及手册内容时,必须保持语言清晰、结构化、可执行。
任务输入模板
## 任务目标
请完成什么事情。
## 背景信息
为什么要做这个修改。
## 修改范围
允许修改哪些文件或目录。
## 不允许修改
明确禁止修改哪些内容。
## 期望结果
完成后应该达到什么效果。
## 检查方式
如何确认修改成功。
## 输出要求
请列出:
1. 修改的文件
2. 每个文件的修改原因
3. 是否需要人工确认
4. 是否有风险任务示例
## 任务目标
请在内部手册中新增一篇「新人入职账号配置」文档。
## 背景信息
新成员加入团队时,经常不知道需要注册哪些账号、找谁开权限、如何确认配置完成。
## 修改范围
只允许修改:
- content/docs/onboarding/
- content/docs/index.mdx
- sidebar/navigation 配置文件,如项目中存在
## 不允许修改
- 不要修改部署配置
- 不要修改 package.json
- 不要新增依赖
- 不要修改样式组件
## 期望结果
新增一篇结构清晰的 MDX 文档,包含:
1. GitHub 账号
2. Vercel 权限
3. 内部工具
4. 文档编辑流程
5. 权限申请负责人
6. 完成检查清单禁止事项
Codex 不允许:
- 未经要求重构整个项目。
- 未经要求修改部署配置。
- 未经要求修改认证和权限配置。
- 未经要求升级依赖。
- 未经要求删除文档。
- 未经要求更改目录结构。
- 伪造测试结果。
- 生成真实密码、Token 或密钥。
- 把内部敏感信息写进公开文档。
- 把模糊需求当成确定事实写入手册。
输出要求
Codex 完成任务后必须说明:
- 修改了哪些文件。
- 每个文件为什么修改。
- 如何验证。
- 是否需要人工确认。
- 是否有风险或后续事项。