让codex一次理解、少返工、不乱改代码,关键在于明确目标、上下文、约束、输出和验证五要素:先定义交付结果,再补充触发场景,指出代码位置,划定修改边界并设硬性约束,最后给出可执行的验证方式。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让 Codex 一次理解对、少返工、不乱改代码,关键不是堆字数,而是把目标、上下文、约束、输出和验证方式这五件事说清。Codex 不是猜谜游戏参与者,它只执行你明确交代的指令。
先说清楚“要什么”,而不是“怎么干”
第一步:用一句话写出最终交付物,聚焦结果而非动作。比如不要写“优化登录页”,而要写【登录页在 iPhone SE 屏幕上不能出现横向滚动,且提交按钮必须完整可见】。
第二步:立刻补上触发条件或用户场景。例如:“当前用户在 Safari iOS 17.5 下访问时复现该问题”。没有这个上下文,Codex 可能按 Chrome 桌面端逻辑去改,白忙一场。
第三步:指出已有实现位置。直接写“相关代码在 src/pages/auth/LoginPage.tsx 第 42–89 行”,Codex 就不会去动 src/components/Button.tsx 这类无关文件。
明确划出“能改”和“不能碰”的边界
方法一:用“只改……不改……”句式锁定范围。
只改 src/api/auth.ts 中的 login 函数体;不改路由定义、不改 token 存储逻辑、不新增任何依赖。
方法二:对高风险操作加硬性约束。
数据库 schema 不得变更;已有接口返回字段结构必须保持完全一致;所有修改必须兼容 TypeScript 5.4 类型检查。
【如果 Codex 自行添加了新的 HTTP 状态码(如 422 或 403),说明它越界了,必须回退】。这类错误一旦合并,前端会因未处理新状态码而崩溃。
通过本地 Codex 或 OpenClaw OAuth 凭证直接调用 ChatGPT/Codex Responses 的 image_generation 工具来生成或编辑光栅图像,然后保存
告诉 Codex 怎么才算“做完了”
运行 pytest tests/api/test_auth.py --tb=short,全部通过且覆盖率不低于 85%。
打开 http://localhost:3000/login,在 Chrome DevTools 切换到 iPhone SE 模拟器,手动点击登录按钮,确认无滚动条、按钮无截断、控制台无 layout warning。
对比 src/api/auth.ts 修改前后 diff,确认仅新增了验证码校验逻辑,未改动 JWT 解析部分。
复杂任务必须先拆解再执行
第一步:先让它分析,不许动代码。
请阅读项目结构,列出实现“订单退款功能”需修改的全部文件路径,并标注每个文件的修改类型(新增/重写/扩写)。
第二步:等它输出计划后,你再确认是否包含数据库迁移脚本。
若计划中没提 alembic revision,则说明它忽略了 schema 变更,必须叫停。
第三步:计划通过后,才发正式执行指令。
请在 alembic/versions/ 下生成新迁移文件,并在 src/services/refund_service.py 中实现核心逻辑。










