如何把需求说清楚

返回 Codex 教学总目录

读完能做到什么

准备可重复的起点

从练习材料复制 expected 到全新的 codex-prompt-lab；不要沿用上一课已改过文字的副本。根目录应有五个档案，先开启 index.html，找到 New task 标签、Add task 按钮与 Read the project README 提示文字。这三个可见字串就是本篇的来源；不需要贴整个专案进对话。

已完成第一个小专案者可使用相同预览方式。Windows 在副本执行 py -m http.server 4173 --bind 127.0.0.1；macOS／Linux 执行 python3 -m http.server 4173 --bind 127.0.0.1，浏览 http://127.0.0.1:4173。这一课不需要先学 Git，但要保留原版，以便确认差异或取回自己改过的档案。

第一步：找出模糊要求缺了什么

「帮我把表单改得更好」没有说给谁用、哪里不好、能改哪些地方，或怎样算完成。Codex 可能改色彩、栏位、按钮、资料结构，甚至加入你没需要的新套件；这不一定是它做错，而是需求允许太多不同解读。先用一句话说出读者要做到的事，例如「新使用者能看懂怎么新增一笔小任务」。

接著补四种资讯：目标、现况来源、限制、验收。它们不是每次都要四个标题的格式，而是防止重要资讯漏掉的检查方式。小幅改字只需几行；跨多个档案的新功能，才需要背景与分段计划。不要为了看起来专业而塞入没用的角色设定、工具清单或假装精确的工时。

第二步：写出完整可执行需求

下方是本篇完整提示词，输入到已选定 codex-prompt-lab 的 Codex 任务，而不是作业系统终端机。它明确指出一个 HTML 档案与两个字串变更，保留无障碍标签、事件系结与资料格式，最后要求实际检查。New task 保持不变是为了保留表单的可见标签，不是要把所有文字强行改成同一个词。

Goal: make the existing todo form wording clearer for a first-time visitor.
Context: this folder is the unchanged Small Steps expected practice version.
In index.html only:
- Change the submit button text from "Add task" to "Save task".
- Change the input placeholder to "Plan one small step".
Keep the visible "New task" label, input id/name, maxlength, required attribute,
button type, JavaScript behavior, stored data and all other files unchanged.
Do not install packages or deploy anything.
Validate by adding Read, completing it, checking Completed, and refreshing.
Check that whitespace-only input does not create a task.
Run node --test core.test.mjs. If browser checks are unavailable, list them as not run.
Report the exact changed strings, files and evidence.

背景已经在档案里的资讯，让 Codex 先读档即可；指向精确档名比复制整份历史纪录更有用。如果实际画面没有 Add task，先停下核对是否使用原版。不要将不符合起点的要求硬套上去，或让它在所有档案搜寻相似文字后全部替换。可重现范例的第一个条件就是起点一致。

第三步：用成果判断，而不是看回答长度

完成后开启 index.html，应只看到按钮文字与 placeholder 改动。New task 仍是与输入框相连的标签，type="submit"、id、name、maxlength、required 都保留。再开其他四个档案与原版比较，确认没有顺手改架构。若 Codex 回复很短但差异正确、验证完整，这仍然是好交付；很长的说明不能替代缺少的档案与结果。

在 http 预览新增 Read，勾选完成，Completed 应只显示已完成项目，重新整理后保留。空白输入不能新增项目；Tab 焦点仍可到达输入与提交按钮。这些行为应与修改前一致。若只有文字改对、按钮不能提交，表示验收失败，下一轮要指出实际现象，而不是笼统说「不好用」。

结果不符时，补充一个可重现例子

假设只看到 Save task 改对，而 placeholder 还是旧文。先确认浏览器重新整理及档案已存档，再发下方追补。这里明列已正确的部分、目前错误与预期，不要求把整个页面重做。若是你在中途改了需求，也要说明哪个条件取代前一版，避免两组相反要求同时留在任务里。

The button text is correct; preserve that change.
After saving and refreshing, the placeholder still reads "Read the project README".
Expected placeholder: "Plan one small step".
Inspect index.html and correct only the remaining placeholder mismatch.
Report the relevant diff and any verification you can actually perform.

更复杂的情况可以先用Plan 模式列出步骤与不确定点，但规划不是验证。计划说会跑测试，不代表测试已执行；回答说会保留资料，也要检查真实资料与程式。当需求有会改变方案的缺口，例如是否需要登入或同步，先回答这种问题，再开始相依功能，通常比做完重工更省事。

三种常见问题与修正

改太多：检查需求是否用了「全面最佳化」「顺便全部整理」等扩张范围的字句，改为列出指定档案与保留项目，再逐项还原无关差异。一直问问题：补足真正影响决策的条件，普通字型或档名选择可授权它依既有风格决定。回答看似完成却没证据：要求列出实际命令结果与未执行项目，不要求它换句话说「已完成」。

遇到反复失败，先保留最小重现资料、错误文字与最后已知正常状态，再缩小到一个问题；不要每次都重贴整段无关历史。若任务长到需要交接，可用上下文交接储存目前决策。反复要求的专案惯例则放入 AGENTS.md，每次提示词只留下这次要完成的变更。

小练习、还原与来源

延伸练习请从另一份全新的 expected 副本开始，先确认按钮是 Add task、placeholder 是 Read the project README；不要接著使用刚才已改过的副本。自行写提示词：只把按钮改为 Create task，保留这份副本的原始 placeholder。验收要指出 index.html 唯一改动的字串，并重做新增、空值与重新整理。结束后用保留的 expected 原版恢复各练习副本的 index.html，其他档案不需替换；Python 伺服器用 Ctrl+C 停止。关闭 Codex 对话不会自动撤销改字。

提示词原则依 2026-09-14 的官方 Prompting 文件核对，表单需求、输入范例与验收方法是本系列原创。相同英文提示词在五语内容保持一致；模型回应不保证逐字相同，验收看实际成果。下一步可练新增功能或修 Bug，把可重现输入与预期结果带入更大任务。

返回 Codex 教学总目录

阅读完整文字说明

Goal to Constraints to Acceptance

• AI 工具
• 教程
• Codex