大家好,我是云途。今天先不写代码。我们要把“我想做个 AI 项目”改成一份七天后可以检查的交付说明。
这期课程以个人作品主页为例。最终结果是一张手机和电脑都能打开的单页,里面有真实介绍、三个作品和一种有效联系方式。
先理解今天的原理
Agent 能执行清楚的任务,却无法替你决定项目应该服务谁。目标含糊时,它会自行补全页面类型、内容和功能,结果常常看起来完整,却没有解决你的实际需要。
一份可执行目标至少包含四项:谁会使用、最终交付什么、明确不做什么、用哪些证据判断完成。四项写清后,后面的结构、内容和检查才有共同标准。
为什么今天要做这件事
- 七天时间很短,目标过大会让每天都在赶工。
- 先定验收标准,可以避免后面只凭“好不好看”判断结果。
- 明确边界能保护原项目、账号、隐私资料和生产环境。
开始前检查
这是第 01 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。
- 准备一个独立的空目录,不要直接在正式项目里练习。
- 确定一个真实使用者,例如潜在客户、招聘方或合作伙伴。
- 准备纸笔或 Markdown 文件,用来保存项目任务书。
一步一步完成
第 1 步:先选一个七天内做得完的使用场景
先写清谁会打开这个页面,以及他为什么打开。这里不要写“所有人”,也不要只写“展示自己”。对象越具体,后面的内容越容易取舍。
- 打开空白 Markdown 文件,先写标题
PROJECT-BRIEF.md。 - 写下一位真实使用者,例如“第一次了解我的潜在合作伙伴”。
- 补上使用时刻,例如“在微信里收到链接后,用手机快速了解我做过什么”。
- 用一句话检查:这位使用者打开页面后,最想确认什么。
完成这一步后,你应该看到:你得到一条完整场景,里面同时出现具体使用者、打开页面的时刻和他要解决的问题。

第 2 步:把七天后的交付物写成看得见的东西
“学会做网站”很难检查。交付物要能打开、能查看或能发给别人。本期案例是一张个人作品主页,所以要说明页面里有什么,以及别人能完成什么动作。
- 写明最终只有一张响应式单页。
- 列出页面必须包含的真实介绍、三个作品和一种联系方式。
- 写明页面需要在电脑和手机浏览器打开。
- 把“学习、了解、掌握”换成“打开、看到、点击、发送”这类可观察动作。
完成这一步后,你应该看到:任何人读完交付物说明,都能说出七天后应该打开哪个页面、看到哪些内容、完成哪个动作。

第 3 步:划出这期课程的边界
七天项目最容易在中途膨胀。想到登录、后台、支付或博客时,先把它们写进“不做清单”。这张清单保护的是本期交付时间。
- 在“本期包含”下只保留三项核心内容。
- 在“本期不做”下写明登录、数据库、支付和内容后台。
- 如果某项功能无法帮助访客了解作品或完成联系,也放进不做清单。
- 确认不做清单不会阻止本期页面完成主要用途。
完成这一步后,你应该看到:任务书里同时有包含清单和不做清单;新想法出现时,可以明确判断放在本期还是以后。

第 4 步:写出可以逐项检查的完成标准
完成标准负责回答“做到什么程度才算结束”。每一条都应该对应一次真实检查,避免最后只凭感觉判断页面够不够好。
- 写下本地启动后页面可以打开。
- 写下 390px 手机宽度和桌面宽度都没有横向滚动。
- 写下作品链接和联系方式可以点击。
- 写下页面不得出现编造的人名、项目和数字。
- 逐条问自己:我能通过页面、命令或文件亲眼确认吗。
完成这一步后,你应该看到:至少四条标准都可以打勾,也能说明由谁、在什么位置、用什么动作检查。

第 5 步:让 Codex 只检查任务书
今天的 Codex 任务是找歧义,不是生成页面。先让它指出冲突、缺失和无法验收的表达,再由你决定哪些意见值得采纳。
- 把完成的任务书和下方审查提示词交给 Codex。
- 要求它分别列出歧义、范围冲突和无法检查的标准。
- 逐条修改任务书,不直接接受它增加的新功能。
- 再让 Codex 复查一次;没有阻断问题后保存文件。
完成这一步后,你应该看到:Codex 只返回审查意见,没有创建代码;最终任务书可以在一分钟内讲清使用者、交付物、边界和完成标准。

# PROJECT BRIEF
## 使用者和场景
谁会在什么情况下打开这个页面?
## 七天交付物
七天后可以打开、查看或分享的具体结果是什么?
## 本期包含
-
-
-
## 本期不做
-
-
-
## 完成标准
- [ ]
- [ ]
- [ ]
- [ ]请只审查 PROJECT-BRIEF.md,不创建、修改或删除任何文件。
请分别列出:
1. 哪些句子存在两种理解;
2. 哪些要求互相冲突;
3. 哪些完成标准无法通过页面、命令或文件检查;
4. 哪些内容明显超过七天范围。
不要替我增加功能。每一条建议都说明原因,等我确认后再修改任务书。这次真实操作得到了什么

- 先写清目标用户、页面顺序、三项真实内容和验收条件;登录、数据库、付款与虚构资料明确排除。
本次实际结果:第 1 天没有写代码,得到的是一份以后能够逐项核对的任务书。
正确结果长什么样
完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。
- 任务书能在一分钟内说明使用者、交付物和范围。
- 每条完成标准都能通过打开页面、点击链接或查看文件来验证。
- 明确写出了本期不做的内容。
- Agent 的检查意见已经处理,任务书里没有互相冲突的要求。
常见错误与恢复
补上使用者和使用场景,说明这些功能帮助谁完成什么。
改成宽度、链接、内容和启动方式等可观察结果。
删掉登录、数据库、支付和后台,只保留一个可分享页面。
留给明天的材料
结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。
PROJECT-BRIEF.md项目任务书。- 四条已经确认的完成标准。
- 一份“不在本期处理”的功能清单。
第 01 天完成检查
- 任务书能在一分钟内说明使用者、交付物和范围。
- 每条完成标准都能通过打开页面、点击链接或查看文件来验证。
- 明确写出了本期不做的内容。
- Agent 的检查意见已经处理,任务书里没有互相冲突的要求。