DeepDojo.AI发布 2026-11-17English

把模糊需求改写成 Codex 能执行的任务

CodexAI 编程

“帮我优化一下这个项目。”这句话交给 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 知道往哪走,你也知道回来时该查什么。

Codex 入门必知 →

审查几条请求里缺少、冲突或多余的信息,把模糊请求改写成可执行任务,再把混在一起的目标拆成一个当前任务和几项暂缓事项。

RSS 订阅