DeepDojo.AI发布 2026-11-17English
把模糊需求改写成 Codex 能执行的任务
“帮我优化一下这个项目。”这句话交给 OpenAI 的 Codex,它会认真去做,只是方向得靠它自己猜:优化按钮交互、加载速度,还是重构组件、补测试?如果你真正想解决的是登录页“邮箱留空直接提交,页面没有任何提示”,它猜中的概率并不高。
就算方向猜对了,问题也还没完。你没说过改到什么程度算完成,它交回结果时,你手里只有一句“已经优化好了”,没有任何可以核对的东西。
把需求写清楚,其实只需要四类信息:
- 目标:要完成什么,改变哪个行为;
- 上下文:相关的现象、文件、报错或背景;
- 约束:允许做什么,不能做什么;
- 完成标准:怎样算做完,用什么检查。
四类信息齐了,用你顺手的方式写成几句话就行。真实请求里常常混着好几件事,写之前还要把它们拆开,这一轮只交一个目标。
01 从一句“帮我优化”开始改
把想解决的现象写出来,Codex 才有明确的调查方向。原来的请求是:
帮我优化一下这个项目。如果实际问题是空邮箱提交没有提示,先说明这个现象,就能减少方向上的猜测。更稳的写法是:
请用最小、可信的改动修复登录表单 bug:
用户不输入邮箱直接提交时,页面没有错误提示。
优先查看登录表单相关组件和测试。
只修复这个问题,不要重构登录流程。
完成后说明改了哪些文件,并给出验证方式。现在它知道问题是什么、先看哪里,以及改到什么程度就该停。再读最后一句,还能发现一个缺口:“给出验证方式”只要求交代怎么查,没要求实际查过。可以补上:“空邮箱提交时出现必填提示;填写合法邮箱后按原流程继续,并报告实际检查结果。”
02 任务说明的四类信息
从刚才的改写里,可以拆出四类信息。Codex 官方的最佳实践也建议提示里默认包含这四项,理由是能让 Codex 保持在范围内、少做假设,交回的结果也更容易审查:
Goal:我要完成什么
Context:相关现象、文件、报错或背景是什么
Constraints:允许做什么,不能做什么
Done when:怎样算完成
四类信息齐了,就用你顺手的方式写。短任务几句话就能交代清楚。每一类缺了会怎样,可以这样对照:
| 信息 | 解决什么问题 | 缺少时可能怎样 |
|---|---|---|
| Goal | 明确目标行为 | 猜错方向 |
| Context | 指出调查起点 | 扩大搜索、读错文件 |
| Constraints | 限定改动范围 | 重构公共组件、引入依赖 |
| Done when | 提供验收依据 | 只能听完成声明 |
03 完成标准要写到能检查
写 Done when 时,提前想好怎么验收。可以按改动类型选:
| 改动类型 | 可用的完成标准 |
|---|---|
| 修 bug | 对应测试通过,或按原步骤操作,确认问题已消失 |
| 改文案或样式 | 页面操作能看到新文案、新样式 |
| 补测试 | 测试能运行,且覆盖目标分支 |
| 只读分析 | 输出包含文件依据和建议,不修改文件 |
完成标准要能重复检查。“看起来正常”“体验更好”还需要具体化:点哪个按钮、留空哪个输入框、应出现什么提示。例如要求空邮箱时显示“请输入邮箱”,可以这样验收:
| 操作 | 应看到什么 |
|---|---|
| 打开登录页,邮箱留空后提交 | 出现“请输入邮箱” |
| 填合法邮箱,再按原方式提交 | 必填提示消失,原流程继续 |
合法邮箱也要检查,因为新增校验可能影响正常提交。空值提示出现、合法输入仍按原流程继续,分别对应本次修复和需要保留的行为。
完成标准写到能观察和核对结果就够了,具体怎样实现,可以留给 Codex 在约定范围内选择。检查时若页面运行不了,就报告哪项没做、为什么。标准写得再清楚,也还需要实际观察来确认。
04 背景只给影响判断的那部分
把任务说清楚,只需提供会影响定位、修改和验收的背景。项目历史、团队讨论和完整技术栈,按当前任务需要补充即可。
可以写:
用户在登录页不输入邮箱直接点击登录时,没有看到错误提示。
相关页面是 `/login`,可能涉及 `LoginForm` 组件。通常不用写:
我们这个登录系统最早是去年做的,后来换过几次设计,老板一直觉得体验不好,最近又想统一所有表单风格……逐句检查背景:它是否影响修改位置、实现方式或验收标准?会影响就保留,不相关的历史与讨论等需要时再补。
05 再改两条常见请求
坏请求:
帮我修一下页面。更好:
请修复登录表单在邮箱为空时没有错误提示的问题。
优先查看登录表单组件和相关测试。
只改表单校验和错误提示,不改认证接口。
完成后运行相关测试;如果无法运行,请给出手动检查步骤。坏请求:
帮我看一下测试为什么失败。更好:
请分析当前项目的 `LoginForm` 测试失败原因。先确认实际测试命令。
先运行或阅读相关测试输出,说明失败断言、相关文件和可能原因。
暂时不要修改文件,先给出最小修复计划。写完后再核对四类信息能否同时成立。例如要求新增表单提示,却禁止修改全部表单文件,可能排除了必要改动,这时先澄清范围。若现有校验与新目标冲突,也应先由你确定要保留哪种行为。
06 一条请求只交一个目标
真实请求常常包含好几件事。全塞进同一条任务,Codex 就要同时处理多个目标,改动混在一起也难审查。拆开处理:
原始请求:
登录页有问题:空邮箱不提示,按钮颜色也不对,
顺便把测试补上,校验代码太乱也重构一下。
拆分后:
当前任务:修复空邮箱提交无提示的问题
范围限定在表单校验、错误提示及对应测试
用空邮箱和合法邮箱两种情况检查本次修复
暂缓事项:
1. 按钮颜色调整:单独一个样式任务
2. 补齐其他登录场景的测试:超出本次修复的部分另做
3. 校验代码重构:先让 Codex 只读分析是否真的重复,再决定修复需要证据,对应测试应留在本轮。真正留到以后的,是按钮颜色、其他场景测试和重构这些无关目标。
拆分以后,再逐个问四个问题:目标单一吗,范围可控吗,结果能查吗,风险能接受吗?这四个问题怎样判断,见判断任务能否交给 Codex 的四个标准。暂缓的事可以以后做,轮到它时,再写清目标、背景、限制和检查办法。
任务写清楚了,如果代码不熟、原因还不明确,下一步先让 Codex 只读调查,做法见用 Codex 排查原因不明的 bug。
完成标准写到能观察、能核对,实现方式留给它在范围内选择。这样交出去的任务,Codex 知道往哪走,你也知道回来时该查什么。