让 Codex 动手改代码前,至少准备四类信息:目标、范围、验收方式、禁区。你不必写长文档,但要让它知道“解决什么问题、只能动哪里、怎么证明改好了、哪些事情不能做”。准备越清楚,Codex 越不容易改偏。
先把目标写成可检查结果
不要只说“优化后台体验”,可以改成“后台文章编辑页保存失败时,用站内美观弹窗提示错误,并保留用户已输入内容”。这样的目标能被检查,也能限制 Codex 不去乱改导航、数据库或登录逻辑。
再给范围和禁区
- 范围:相关页面、组件、接口、样式文件。
- 禁区:不要改数据库结构、不要删除历史数据、不要改登录权限。
- 风格:沿用项目现有 UI,不使用原生 alert、confirm、prompt。
验收方式要提前告诉它
如果项目有测试命令,直接告诉 Codex 运行哪个;没有测试,也可以要求它运行构建、打开页面检查,或者说明手动验证步骤。很多“AI 改坏项目”的问题,不是模型不会写代码,而是改完没人验证。
AGENTS.md 很值得写
如果项目经常让 Codex 处理任务,可以在仓库根目录放 AGENTS.md,写清项目结构、常用命令、代码风格、危险操作边界。Codex 会更容易按团队习惯做事,少问重复问题。
一个好用的任务模板
“请在这个项目中修复【具体问题】。优先查看【相关文件或页面】。要求:1. 保持现有设计风格;2. 不修改【禁区】;3. 改完运行【测试命令】;4. 最后说明改动文件、验证结果和剩余风险。”
准备这些信息花不了几分钟,却能明显降低返工。尤其是老项目、生产项目、多人协作项目,先约束边界比事后回滚省心。Codex 很适合执行,但方向盘最好一开始就握稳。