每次修改后做什么？

10-02 每次修改后做什么？

课程定位

这一课讲收工流程。AI 工作台最容易让人兴奋：改完一个地方，又想马上改下一个地方。收工流程会提醒学员停一下，看结果、记历史、保存版本。

本课训练的是稳定闭环：每次修改后，运行检查、人工验收、查看改动、写日志、提交版本。

这一课的成果是一张「收工流程卡」。它会成为学员以后每次和 AI 改项目后的固定动作。

本课目标

• 能在修改后运行或刷新项目。
• 能按照验收清单检查结果。
• 能查看本次改了哪些文件。
• 能更新 README 或工作日志。
• 能完成一次 Git 提交。
• 能把遗留问题放进下一步清单。

录制建议

• 建议时长：28 到 38 分钟。
• 接上一课的今日目标继续演示。
• 改动要很小，方便把注意力放在收尾流程。
• 让学员看到“完成”来自验收和记录。
• 强调收工流程是给明天的自己铺路。

课前准备

• 一个刚完成小修改的项目。
• 修改前目标。
• 浏览器或运行命令。
• Git。
• README 或工作日志。

讲稿正文

可以这样开场：

“AI 改完以后，我们很容易被下一件事吸走。可真正让项目越来越稳的，是每次改完之后的收工动作。”

收工第一步：运行检查。

网页就刷新页面，脚本就重新跑命令。看得到结果，心里才有底。

收工第二步：人工验收。

回到今天的目标，看它是否完成。今天只改标题区域，就只验收标题区域，同时快速看一眼原有内容有没有受影响。

收工第三步：查看改动。

让 AI 列出它改了哪些文件，也可以用 Git 查看差异。这里要培养一个习惯：每次都知道项目哪里变了。

协作文本：

请列出本次修改过的文件。
每个文件用一句话说明改了什么。
请标出是否有超出本次目标的改动。

收工第四步：更新 README 或日志。

如果项目使用方式变了，README 要补。若只是一次普通修改，工作日志也要记：今天做了什么、怎么验收、有没有遗留问题。

收工第五步：提交版本。

Git 提交像在工坊墙上钉一枚时间钉。以后项目跑偏，你还有路回到这一刻。

提交信息写给未来的自己看：

更新首页标题区域
修复页面刷新后样式不生效的问题
补充 README 运行说明

收工第六步：写遗留问题。

“每次修改后，你可能会冒出新想法。不要马上追。把它放进下一步清单，项目就不会被新想法拖散。”

最后收束：

“收工前把战场打扫干净，明天的你会感谢今天的你。AI 负责把活干快，你负责让项目有历史、有边界、有下一步。”

屏幕演示流程

1. 展示本次小修改目标。
2. 刷新页面或运行命令。
3. 对照目标验收结果。
4. 让 AI 列出本次改动文件。
5. 查看 Git 差异。
6. 更新工作日志。
7. 判断 README 是否需要更新。
8. 写一条清楚的提交信息。
9. 完成 Git 提交。
10. 写下遗留问题和下一步。
11. 保存收工流程卡。

给 AI 的协作卡

我刚完成一次小修改。
请帮我做收工检查：
1. 本次目标是否已经达成
2. 需要运行或刷新哪些地方
3. 本次修改了哪些文件
4. README 或工作日志需要补充什么
5. Git 提交信息建议怎么写
6. 哪些新想法应该放进下一步清单

请把输出写成可勾选清单。

收工流程卡

• 本次目标：
• 运行检查结果：
• 人工验收结论：
• 修改文件：
• README 是否更新：
• 工作日志是否更新：
• Git 提交信息：
• 遗留问题：
• 下一步：

课堂练习

让学员对前面完成的小修改执行收工流程。

要求：

• 写一条人工验收结论。
• 记录本次改动文件。
• 完成一条工作日志。
• 写一条 Git 提交信息。
• 有 Git 环境的学员完成提交。

常见卡点

• 学员改完就停：把“运行检查”设为第一步。
• 学员看不懂 Git 差异：先让 AI 用大白话解释改动。
• 提交信息太空：用“完成了什么”来写，比如“更新首页标题区域”。
• README 没更新：判断项目入口、运行方式、注意事项有没有变化。
• 新想法太多：统一放进下一步清单。

课后作业

对自己的项目完成一次收工流程。

提交内容：

• 收工流程卡。
• 工作日志。
• Git 提交截图或提交信息。
• 下一步清单。

课件页建议

• 第 1 页：改完以后，先收工
• 第 2 页：运行、验收、差异、日志、提交
• 第 3 页：Commit 是时间钉
• 第 4 页：README 和日志判断
• 第 5 页：遗留问题进清单
• 第 6 页：收工流程卡
• 第 7 页：收工演示