第8课：怎样判断真的做完了
用验收清单判断第一个 AI 小工具是否真正达到第一版标准。
本课目标
第 8 课是第一册收尾课。
前面 7 课，你已经经历了一个完整过程：
认识软件 -> 发现小麻烦 -> 写项目定义卡 -> 拆软件积木 -> 指挥 AI -> 做出小工具 -> 处理报错最后一步是验收。
AI 说“完成了”，不等于真的完成。
代码写出来了，也不等于真的完成。
真正完成，是你能亲自打开、操作、看到结果，并确认它符合第一版成功标准。
本课结束时，你要完成：
- 一张项目验收清单。
- 一份项目复盘。
- 一个第一册作品档案。
开始之前
你可能会听到 AI 这样说：
功能已经完成。
代码已经更新。
现在可以使用了。这些话只能作为参考。
你要亲自检查：
页面能打开吗？
输入框能输入吗？
按钮能点击吗？
结果对吗？
刷新后还正常吗？
有没有超出第一版范围？
遇到错误能不能描述清楚？验收不是不信任 AI。
验收是软件项目必须经过的一步。
一个小故事
阿宁的“周报生成助手”已经做出来了。
Codex 告诉她：
我已经完成了这个功能。阿宁没有马上继续加“历史记录”和“团队协作”。
她先用自己的成功标准检查：
成功标准：我输入 10 条工作记录，能得到一份结构清楚、可以复制的周报。她做了 5 个动作：
打开页面。
粘贴 10 条工作记录。
点击生成按钮。
查看周报结果。
点击复制按钮。她发现：
页面能打开。
输入能粘贴。
按钮能点击。
结果能生成。
但复制按钮复制的是空内容。所以，这个项目不是“全部完成”，而是：
主流程已跑通。
复制按钮还需要修。这就是验收的价值。
什么叫第一版完成
第一版完成，不是功能很多。
第一版完成，是完成你一开始写下的成功标准。
周报生成助手
成功标准：输入 10 条工作记录，生成一份结构清楚、可以复制的周报。完成就要检查：
- 能输入 10 条记录吗？
- 能生成周报吗？
- 周报结构清楚吗？
- 能复制吗？
小红书标题助手
成功标准：输入产品、目标人群和卖点，得到 5 个可修改的标题。完成就要检查：
- 三个输入是否都能填写？
- 点击后是否有 5 个标题？
- 标题是否和产品相关？
- 是否有明显乱编或跑题？
聊天记录转待办
成功标准：粘贴一段聊天记录后，能得到清楚的待办清单。完成就要检查：
- 能粘贴聊天记录吗？
- 是否能提取待办？
- 有没有负责人或时间？
- 输出能不能直接使用？
第一版验收清单
用这张清单检查你的项目。
| 检查项 | 结果 | 备注 |
|---|---|---|
| 页面能打开 | 通过 / 不通过 | |
| 页面标题和用途清楚 | 通过 / 不通过 | |
| 输入框能输入 | 通过 / 不通过 | |
| 按钮能点击 | 通过 / 不通过 | |
| 点击后结果区有变化 | 通过 / 不通过 | |
| 输出符合项目目标 | 通过 / 不通过 | |
| 输出能被复制或使用 | 通过 / 不通过 / 不需要 | |
| 刷新后页面仍正常 | 通过 / 不通过 | |
| 如果需要保存，记录真的保存 | 通过 / 不通过 / 不需要 | |
| 出错时能看到或描述错误 | 通过 / 不通过 | |
| 没有加入第一版不需要的复杂功能 | 通过 / 不通过 | |
| 达到项目定义卡里的成功标准 | 通过 / 不通过 |
注意最后一项最重要：
是否达到项目定义卡里的成功标准？如果没有达到，就还不能说第一版完成。
三种验收结果
验收后，项目通常会落到三种状态之一。
| 状态 | 特点 | 下一步 |
|---|---|---|
| 第一版完成 | 页面能打开，输入、点击、输出都正常，成功标准达成 | 可以考虑一个最小改进 |
| 主流程跑通，但有小问题 | 主功能能用，但有一个小地方不满意 | 下一步只修一个小问题 |
| 第一版未完成 | 页面打不开、按钮没反应、没有输出或输出完全不对 | 先不要加功能，回到报错描述或最小修复 |
你要学会准确说出项目现在属于哪一种状态。
这比笼统说“做好了”或“失败了”更有用。
不要在验收时偷偷扩需求
新手很容易在验收时突然想：
要不顺便加个登录？
要不顺便保存历史？
要不顺便做个更漂亮的页面？
要不顺便发布到网上？先不要。
验收阶段只回答一个问题：
第一版是否达到原来的成功标准？如果达到了，再写“下一步最小改进”。
如果没达到，先修第一版。
课堂练习：判断完成状态
请判断下面项目属于哪种状态。
可选项：
第一版完成 / 主流程跑通但有小问题 / 第一版未完成| 情况 | 状态 |
|---|---|
| 页面能打开，能输入，能生成标题，但生成了 3 个标题，成功标准要求 5 个 | |
| 页面能打开，能输入，按钮没反应 | |
| 页面能打开，输入 10 条工作记录后生成结构清楚的周报，并能复制 | |
| 页面能打开，但 AI 加了登录和后台，学生不知道怎么用 | |
| 聊天记录能转待办，但复制按钮坏了 | |
| 运行命令失败，页面打不开 |
自己动手：我的项目验收清单
| 项目 | 我的记录 |
|---|---|
| 我的项目名称 | |
| 我的第一版成功标准 | |
| 我输入的测试内容 | |
| 我期待的输出 | |
| 实际输出 | |
| 页面能打开吗 | |
| 输入能使用吗 | |
| 按钮能点击吗 | |
| 输出符合目标吗 | |
| 是否需要保存数据 | |
| 如果需要，刷新后是否还在 | |
| 有没有超出第一版范围 | |
| 我遇到的问题 | |
| 当前状态 | 第一版完成 / 主流程跑通但有小问题 / 第一版未完成 |
项目复盘
验收后，写一份很短的复盘。
| 问题 | 我的复盘 |
|---|---|
| 我做的小工具是 | |
| 它解决的问题是 | |
| 我输入了 | |
| 它输出了 | |
| 最有用的地方是 | |
| 还不满意的地方是 | |
| 我学会了什么 | |
| 下一步只改一件事 |
“下一步只改一件事”很重要。
它可以是：
修复制按钮。
让输出格式更清楚。
把按钮文案改准确。
接入真实 AI。
保存一次历史记录。不要写：
把它做成完整系统。给 AI 的一句话
这是本课验收提示词。
我已经做出了第一版小工具。下面是我的项目定义卡和实际测试结果。
项目名称：
第一版成功标准：
我的测试输入：
实际输出：
验收结果：
页面能打开：
输入能使用：
按钮能点击：
输出符合目标：
刷新后是否正常：
是否需要保存：
是否超出第一版范围：
请你先不要加新功能。
请帮我判断：
1. 这个项目是否达到第一版成功标准。
2. 如果没有达到，最小修复项是什么。
3. 如果已经达到，下一步最小改进是什么。
4. 哪些功能应该继续放到以后再做。
请用新手能看懂的话回答。第一册总复盘
现在回头看，你已经走过了 8 步：
1. 知道软件不是魔法。
2. 知道软件能帮人解决哪些小麻烦。
3. 把小麻烦变成项目定义卡。
4. 把项目拆成软件积木。
5. 写出给 Codex 的启动提示词。
6. 做出第一个能运行的小工具。
7. 学会描述报错。
8. 学会验收第一版是否完成。你现在可能还不会自己写代码。
但你已经具备了 AI 时代做小软件最重要的起点能力：
发现问题
定义项目
控制范围
指挥 AI
运行验证
描述错误
验收结果这就是第一册的目标。
第一册最终交付
学完第一册，请把这些材料放在一起：
| 交付物 | 是否完成 |
|---|---|
| 一张项目定义卡 | |
| 一张软件积木图 | |
| 一条 Codex 启动提示词 | |
| 一个能打开、能输入、能输出的小工具 | |
| 一张项目验收清单 | |
| 一份项目复盘 |
这些材料放在一起，就是你的第一个 AI 小工具作品档案。
本课最低标准
你能说出：
AI 说完成不等于真完成。
真正完成 = 能打开、能输入、能点击、有输出、符合成功标准、没有超出第一版范围。并且你完成了一张项目验收清单和一份项目复盘。
第一册到这里就完成了。
下一步你可以继续完善这个小工具，也可以进入第二册，学习保存数据、终端、Node、Git 和项目继续维护。