修改后检查什么?
06-03 修改后检查什么?
Section titled “06-03 修改后检查什么?”这一课讲修改后的验收。
AI 改完文件后,学员不能只看“它说完成了”。工作台里的完成,要回到运行结果、页面表现、原有功能、文件位置和 README 更新。
这一课要让学员养成“改完必查”的习惯。AI 负责生成结果,学员负责验收结果,项目稳定感就从这里长出来。
- 让学员知道修改完成后要检查哪些地方。
- 让学员会运行或刷新项目。
- 让学员会检查新功能和原有功能。
- 让学员会要求 AI 列出本次改动。
- 让学员完成一张修改验收清单。
- 建议时长:25 到 35 分钟。
- 用刚才的小修改接着演示。
- 检查清单要放在屏幕上逐项勾选。
- 强调“AI 说完成”只是进入验收阶段。
- 录制时要刻意展示人工检查动作。
可以这样开场:
“AI 改完以后,会很自信地告诉你:完成了。这个时候,我们要做项目主人该做的事:验收。”
修改后至少查六项。
第一,项目能不能运行。
如果是网页,刷新或重新打开;如果是脚本,重新跑一次命令。项目跑不起来,其他检查先暂停。
第二,新目标有没有达成。
刚才要改标题,就看标题;刚才要加按钮,就看按钮;刚才要增加联系方式,就看联系方式是否出现在正确位置。
第三,原来的功能有没有保持。
新增东西时,旧内容也要看一眼。标题、按钮、链接、图片、排版,这些都要简单扫一遍。
第四,文件是否改在正确位置。
让 AI 说明它改了哪些文件:
请列出你本次修改过的文件。每个文件用一句话说明改了什么。第五,输出是否符合预期。
页面、文件、终端输出都算结果。学员要学会说清楚“我看到的结果是什么”。
第六,README 或日志是否需要更新。
项目变了,说明文档也要跟着变。小修改可以只写进日志;关键功能变化要同步 README。
验收时可以用这段协作文本:
我已经看到了修改结果。请根据这次修改目标,帮我生成一张验收清单。清单要包含:新目标、旧功能、改动文件、运行结果、README 或日志更新。如果发现问题,不要马上抛一句“没成功”。要把现象说清楚:
修改后页面能打开。但联系方式区域没有出现在页面底部,而是挤在标题下面。请先判断可能原因,再给一个最小修复计划。最后收束:
“验收是在帮项目上保险。你每验收一次,项目就稳一分。AI 的速度负责往前冲,你的验收负责让项目落地。”
屏幕演示流程
Section titled “屏幕演示流程”- 接上一课的小修改。
- 运行或刷新项目。
- 检查新修改是否出现。
- 检查原来的标题、按钮、链接是否正常。
- 让 AI 列出本次改动文件。
- 打开文件区,对照改动文件。
- 判断 README 或日志是否需要补充。
- 填写修改验收清单。
- 如果发现问题,向 AI 描述具体现象并要求最小修复计划。
修改验收清单
Section titled “修改验收清单”- 项目能运行。
- 新目标已达成。
- 原有功能正常。
- 改动文件清楚。
- 输出符合预期。
- README 或日志已更新。
- 问题现象已经记录。
- 下一步动作已经明确。
学员拿上一课完成的小修改,逐项填写验收清单。
要求:
- 至少截图一张结果。
- 至少写一句人工验收结论。
- 让 AI 列出改动文件。
- 判断是否需要更新日志。
人工验收结论示例:
本次修改已完成。页面底部出现联系方式区域,原来的标题和按钮仍然正常。已将结果写入工作日志。- 学员只看新功能:提醒他也看原有功能。
- 学员没运行就结束:把运行检查放在第一项。
- AI 不说明改了哪里:要求它列出文件清单。
- README 忘记更新:每次稳定修改后看一眼 README。
- 发现问题后说不清楚:描述看到的位置、现象、期待结果。
为一次真实修改填写验收清单,并保存结果截图。
补充要求:
- 写一条人工验收结论。
- 把验收清单放进
logs文件夹。 - 如果 README 需要更新,写一句更新说明。
- 第 1 页:标题“AI 改完,人来验收”
- 第 2 页:能不能运行
- 第 3 页:目标是否达成
- 第 4 页:原功能是否正常
- 第 5 页:文件和输出
- 第 6 页:README 和日志
- 第 7 页:发现问题怎么说
- 第 8 页:验收清单