第 3 天
写第一份正式工作说明书
今天不急着让 Codex 动手。先把真实问题、修改范围、完成标准和验证证据写进同一份说明书,再检查计划是否逐条对应。
- 建议时间
- 50-70 分钟
- 完成标志
- 正式工作说明书 + 修改计划
一份工作说明书要解决什么
它不是越长越专业,而是让四件事彼此一致:为什么改、允许改什么、怎样算完成、用什么证据证明。Codex 可以帮助补结构,但目标用户和真实问题必须由你判断。
说明服务谁,以及这次变化要解决什么。
写清允许修改和明确禁止的内容。
让每条要求都能被真实检查。
先补齐三项人的判断
这些输入不会保存。整理清楚后,手动替换进下面的说明书。
把目标、边界和测试写在一起
这份练习继续修改个人造物名片,只增加一个公开造物计划区域。先替换方括号内容,再整段发送给 Codex。
正式工作说明书
工作说明书:为个人造物名片增加“公开造物计划”
一、背景与当前状态
我是零基础学习者,已经完成个人造物名片网页,并验证按钮可以显示反馈。当前项目可以在本地正常打开。
二、目标用户与真实问题
目标用户:[填写谁会看或使用这个页面]
真实问题:[填写他在什么场景里缺少什么信息或行动支持]
三、本次目标
在现有页面中增加一个“公开造物计划”区域,让访问者能看见:我准备帮助谁、第一版只做什么、下一次准备怎样验证。
四、允许修改
当前项目文件夹中实现这个区域所必需的网页和样式文件。
五、禁止修改
不重写现有页面;不删除原有内容;不改变按钮已有行为;不安装依赖;不接入数据库、登录、支付或外部服务;不修改项目文件夹以外的内容。
六、期望行为
1. 新区域位于“我准备做的小项目”之后、按钮之前。
2. 区域标题为“我的公开造物计划”。
3. 展示“服务谁”“第一版”“下一次验证”三项真实内容。
4. 原有按钮仍能显示第 2 天修改后的反馈文字。
七、完成标准
1. 页面可以按原方式打开和刷新。
2. 新区域的三项内容完整可读。
3. 原有昵称、问题、项目和按钮内容不丢失。
4. 点击按钮后反馈正常。
5. 390 像素宽度下没有横向滚动,文字和按钮不被截断。
八、验证与证据
逐项报告完成标准的通过、未通过或未验证状态;列出实际修改的文件;保留桌面截图、手机宽度截图和按钮反馈截图。
九、执行方式
先阅读项目和本说明书,只输出:现状摘要、计划修改的文件、按顺序排列的修改计划、验证计划和风险。不要修改文件,等待我确认。检查计划是否逐条对应
一个看起来很努力的计划,也可能悄悄增加重构和新功能。用下面这段指令,把每个动作拉回到明确要求上。
计划审查
请根据刚才的工作说明书检查你的计划,先不要执行。
请用表格回答:
1. 每一项计划对应工作说明书中的哪条要求?
2. 准备修改哪个真实存在的文件?
3. 这项修改完成后怎样验证?
4. 哪些原有行为必须保持不变?
5. 是否有无法确认的信息或需要我决定的内容?
删除所有没有对应要求的动作。如果计划符合范围,请在最后明确写“等待确认后执行”。目标新增公开造物计划区域
允许修改当前项目中必要的网页和样式文件
保持现有内容、打开方式和按钮反馈
拒绝重写页面、安装依赖、接入外部服务
在执行前停下来
今天的终点是确认一份可执行计划,不是抢跑完成页面。你应该能逐项说明计划为什么存在、会修改哪里、如何验证,以及哪些内容不会动。
正式工作说明书 + 修改计划
把两份文字保存好。第 4 天将按这份计划执行、运行和测试,届时“Codex 说完成了”仍然不算证据。
进入第 4 天