7 天完成第一个 AI 项目

先定义一个七天后
能交付的结果

用使用者、交付物、边界和验收标准,把模糊想法收成一个能在七天内完成的项目。

预计阅读 18 分钟公开免费核验于 2026.08.19
内容目录 当前:第 01
7 天完成第一个 AI 项目7
7 天学会 DeepSeek Harness7
7 天建立 Agent 工作流7
7 天做出个人知识库7
本文目录 8 个部分

大家好,我是云途。今天先不写代码。我们要把“我想做个 AI 项目”改成一份七天后可以检查的交付说明。

这期课程以个人作品主页为例。最终结果是一张手机和电脑都能打开的单页,里面有真实介绍、三个作品和一种有效联系方式。

先理解今天的原理

Agent 能执行清楚的任务,却无法替你决定项目应该服务谁。目标含糊时,它会自行补全页面类型、内容和功能,结果常常看起来完整,却没有解决你的实际需要。

一份可执行目标至少包含四项:谁会使用、最终交付什么、明确不做什么、用哪些证据判断完成。四项写清后,后面的结构、内容和检查才有共同标准。

七天项目从结果定义出发,经过材料、结构、实现和验证,最后形成可以交付的版本。结果材料结构实现检查减法交付
七天项目从结果定义出发,经过材料、结构、实现和验证,最后形成可以交付的版本。

为什么今天要做这件事

  1. 七天时间很短,目标过大会让每天都在赶工。
  2. 先定验收标准,可以避免后面只凭“好不好看”判断结果。
  3. 明确边界能保护原项目、账号、隐私资料和生产环境。

开始前检查

这是第 01 天。先完成下面的检查,再开始操作。缺少关键材料时,先补材料,不要让 Agent 猜。

  1. 准备一个独立的空目录,不要直接在正式项目里练习。
  2. 确定一个真实使用者,例如潜在客户、招聘方或合作伙伴。
  3. 准备纸笔或 Markdown 文件,用来保存项目任务书。

一步一步完成

第 1 步:先选一个七天内做得完的使用场景

先写清谁会打开这个页面,以及他为什么打开。这里不要写“所有人”,也不要只写“展示自己”。对象越具体,后面的内容越容易取舍。

  1. 打开空白 Markdown 文件,先写标题 PROJECT-BRIEF.md
  2. 写下一位真实使用者,例如“第一次了解我的潜在合作伙伴”。
  3. 补上使用时刻,例如“在微信里收到链接后,用手机快速了解我做过什么”。
  4. 用一句话检查:这位使用者打开页面后,最想确认什么。
完成这一步后,你应该看到:你得到一条完整场景,里面同时出现具体使用者、打开页面的时刻和他要解决的问题。
三个七天项目候选的真实比较表,个人作品主页被选为本周项目
软件实拍 01:Computer Use 在 VS Code 中截取候选比较文件;先保存限制和主要风险,再选择个人作品主页。

第 2 步:把七天后的交付物写成看得见的东西

“学会做网站”很难检查。交付物要能打开、能查看或能发给别人。本期案例是一张个人作品主页,所以要说明页面里有什么,以及别人能完成什么动作。

  1. 写明最终只有一张响应式单页。
  2. 列出页面必须包含的真实介绍、三个作品和一种联系方式。
  3. 写明页面需要在电脑和手机浏览器打开。
  4. 把“学习、了解、掌握”换成“打开、看到、点击、发送”这类可观察动作。
完成这一步后,你应该看到:任何人读完交付物说明,都能说出七天后应该打开哪个页面、看到哪些内容、完成哪个动作。
七天任务书中目标用户、具体交付物和可观察动作的真实记录
软件实拍 02:Computer Use 截取 VS Code 中的真实任务书;目标用户、交付物和页面顺序写在同一份文件里。

第 3 步:划出这期课程的边界

七天项目最容易在中途膨胀。想到登录、后台、支付或博客时,先把它们写进“不做清单”。这张清单保护的是本期交付时间。

  1. 在“本期包含”下只保留三项核心内容。
  2. 在“本期不做”下写明登录、数据库、支付和内容后台。
  3. 如果某项功能无法帮助访客了解作品或完成联系,也放进不做清单。
  4. 确认不做清单不会阻止本期页面完成主要用途。
完成这一步后,你应该看到:任务书里同时有包含清单和不做清单;新想法出现时,可以明确判断放在本期还是以后。
七天任务书中本期必须完成与本周明确不做的范围对照
软件实拍 03:VS Code 任务书中的真实范围记录;必须完成与本周不做分开列出。

第 4 步:写出可以逐项检查的完成标准

完成标准负责回答“做到什么程度才算结束”。每一条都应该对应一次真实检查,避免最后只凭感觉判断页面够不够好。

  1. 写下本地启动后页面可以打开。
  2. 写下 390px 手机宽度和桌面宽度都没有横向滚动。
  3. 写下作品链接和联系方式可以点击。
  4. 写下页面不得出现编造的人名、项目和数字。
  5. 逐条问自己:我能通过页面、命令或文件亲眼确认吗。
完成这一步后,你应该看到:至少四条标准都可以打勾,也能说明由谁、在什么位置、用什么动作检查。
页面视口、操作、内容和首次访问者任务组成的真实验收清单
软件实拍 04:Computer Use 截取 VS Code 中的验收方法和冻结条件,每一条都能实际执行。

第 5 步:让 Codex 只检查任务书

今天的 Codex 任务是找歧义,不是生成页面。先让它指出冲突、缺失和无法验收的表达,再由你决定哪些意见值得采纳。

  1. 把完成的任务书和下方审查提示词交给 Codex。
  2. 要求它分别列出歧义、范围冲突和无法检查的标准。
  3. 逐条修改任务书,不直接接受它增加的新功能。
  4. 再让 Codex 复查一次;没有阻断问题后保存文件。
完成这一步后,你应该看到:Codex 只返回审查意见,没有创建代码;最终任务书可以在一分钟内讲清使用者、交付物、边界和完成标准。
Codex 对任务书歧义、范围冲突、可验收性和七天范围的真实只读审查结果
软件实拍 05:Computer Use 截取保存在 VS Code 中的 Codex 审查结果;本次只审查任务书,没有创建页面代码。
任务书模板MARKDOWN
# PROJECT BRIEF

## 使用者和场景
谁会在什么情况下打开这个页面?

## 七天交付物
七天后可以打开、查看或分享的具体结果是什么?

## 本期包含
- 
- 
- 

## 本期不做
- 
- 
- 

## 完成标准
- [ ] 
- [ ] 
- [ ] 
- [ ]
先按自己的真实情况填写,不要照抄案例里的身份和作品。
让 Codex 审查目标TEXT
请只审查 PROJECT-BRIEF.md,不创建、修改或删除任何文件。

请分别列出:
1. 哪些句子存在两种理解;
2. 哪些要求互相冲突;
3. 哪些完成标准无法通过页面、命令或文件检查;
4. 哪些内容明显超过七天范围。

不要替我增加功能。每一条建议都说明原因,等我确认后再修改任务书。
Codex 给出的是审查意见,功能取舍仍由你决定。

这次真实操作得到了什么

S01 第 1 天真实操作结果
任务书与候选方向已经保存
  1. 先写清目标用户、页面顺序、三项真实内容和验收条件;登录、数据库、付款与虚构资料明确排除。
本次实际结果:第 1 天没有写代码,得到的是一份以后能够逐项核对的任务书。

正确结果长什么样

完成操作后,用结果来判断今天是否学会。页面能打开或命令能运行,只能说明流程启动了;下面这些证据同时出现,今天才算完成。

  1. 任务书能在一分钟内说明使用者、交付物和范围。
  2. 每条完成标准都能通过打开页面、点击链接或查看文件来验证。
  3. 明确写出了本期不做的内容。
  4. Agent 的检查意见已经处理,任务书里没有互相冲突的要求。

常见错误与恢复

目标写成功能清单

补上使用者和使用场景,说明这些功能帮助谁完成什么。

验收标准写成“高级、好看”

改成宽度、链接、内容和启动方式等可观察结果。

范围仍然很大

删掉登录、数据库、支付和后台,只保留一个可分享页面。

留给明天的材料

结束前把今天的关键结果保存到项目目录。下一天会直接使用这些材料,保存清楚可以减少重复说明和错误猜测。

  1. PROJECT-BRIEF.md 项目任务书。
  2. 四条已经确认的完成标准。
  3. 一份“不在本期处理”的功能清单。
完成检查

第 01 天完成检查

  • 任务书能在一分钟内说明使用者、交付物和范围。
  • 每条完成标准都能通过打开页面、点击链接或查看文件来验证。
  • 明确写出了本期不做的内容。
  • Agent 的检查意见已经处理,任务书里没有互相冲突的要求。

官方依据与延伸阅读

Codex 系统教学:写任务书实战项目:个人作品主页图文教程:Git 三个只读检查