一套AI培训讲义改到第四版才敢发学员：教研视角的编写与迭代复盘
AI培训讲义不是讲稿的复印件，而是学员课后能独立照着做的自学物料。这套东西怎么编、怎么改、怎么判断改对了，作者以教研视角复盘一套讲义从初稿到第四版的全过程：213张截图怎么备才耐放、工具改版后怎么两个晚上补完、学员自学后哪些页面被翻烂、哪些从没被打开，都写在下面。
AI培训讲义值不值得下这么大功夫，我到今年才算想透：课讲得再热闹，学员回去能依赖的只有讲义。我原本在制造行业做了八年质量管理，今年年初转岗做AI课程教研，接手的第一个活不是上台讲课，而是把一门三天课的讲义推倒重写。旧讲义说白了就是老师上课念的PPT导出成PDF，一百二十多页，一半篇幅是术语定义，学员拿到手翻两下就塞进了包里。真正能用的讲义和讲稿是两种东西——讲稿管课上的九十分钟，讲义管课后的三十天。我花大半年把这套东西重建了一遍，改到第四版才敢说它是一件能独立交付的物料，下面把过程里的坑和数据摊开讲。
一套能用的讲义，截图比文字更难伺候
备截图的关键不是好看，而是耐放：只截最小必要区域、每张配一行文字操作路径、绕开容易挪位置的入口按钮，这样工具改版时损失最小。讲义里最费工的从来不是写字，是截图。第一版今年3月中旬定稿，87页正文配了213张截图，平均一页摊两张多。一开始我图省事整屏整屏地截，侧边栏、顶部导航全带着，看着信息很全。结果4月中旬主力绘图工具界面改版，侧边栏图标换了一轮，62张截图一夜作废。62张。我对着屏幕坐了半天。
从那以后我给自己立了三条规矩。第一，只截操作涉及的最小区域，能不带的导航一律不带；第二，每张截图下方必须配一行文字路径，比如"左侧边栏→智能体→创建"，红框圈点只做辅助不做唯一线索；第三，凡是有可能挪位置的入口按钮，尽量用文字描述替代截图。截图文件也统一按"章节号-步骤号"命名存放，重截的时候照着清单批量补，不用翻全稿找。4月那次吃亏之后，6月小改版我只补了9张图，一个下午搞定。
说个主观判断：我觉得截图在讲义里的作用被高估了。文字路径才是骨架，截图只是拐杖。学员照着一行文字路径去点，比对着三个月前的旧截图满屏找按钮靠谱得多。宁可少截两张图，也要把路径写死。
工具一更新，讲义只能推倒重来吗？
别把讲义绑死在某个界面版本上：把操作逻辑和界面细节分层写，版本号管起来，改版时只补截图不动骨架，两个晚上能补完。8月那次主力对话工具大改版，按钮名称换了一批，界面布局动了三处。我把修补压在了两个晚上：第一晚照清单重截14张图替换，第二晚过一遍全稿，把涉及旧按钮名的描述统一改成新叫法。能做到这个速度，靠的全是4月那次吃过的亏。
讲义文件我一直带版本号管理，每次改动记一行，半年下来就攒出了这张迭代记录表。
| 版本 | 定稿时间 | 主要改动 | 触发原因 |
|---|---|---|---|
| v1.0 | 今年3月中旬 | 87页初稿，213张截图 | 接手旧稿后全新编写 |
| v2.0 | 今年4月底 | 作废62张截图重截，新增通用操作逻辑一章 | 主力绘图工具界面改版 |
| v3.0 | 今年6月初 | 压缩两章案例，附录新增答疑高频五问 | 23份学员问卷反馈 |
| v4.0 | 今年8月中 | 拆出12页速查卡，正文减到70页 | 试读学员反馈翻不到重点 |
这张表后来成了我向项目组汇报进度时唯一被追问的东西。结构上，我把"这一类工具的通用操作逻辑"单独成章——怎么下指令、怎么给参考图、怎么迭代结果，这些不随界面变，写一次能吃一年。界面相关的具体步骤全部压到各章前半段，方便局部替换。每章末尾再留"本章自测三件事"，学员照做一遍就知道自己会不会。这套分层办法没什么高深的，难的是忍住不在正文里堆界面细节。
学员自学之后，翻烂的页和没人看的页最诚实
判断讲义该改哪里，别靠自己的感觉，看学员自学时翻哪页、卡哪页：操作步骤和报错处理页被翻烂，理念案例页基本没人打开。6月底我给第三期学员发了匿名问卷，收回23份。有两个数字我印象很深：87%的人把"常见报错怎么办"那一页单独存进了手机相册；而我最花心思写的两章行业案例，自述完整看过的人不到三成。三天的心血，就这么输给一页报错对照表。这事我认。
微信答疑记录是另一条更细的线索。学员问得最多的问题，几乎都落在讲义里一笔带过的地方，比如"截图里这个按钮我找不到""我按步骤做了没反应"。我把6月到7月的答疑记录翻出来归了类，排前五的问题直接写进v3的附录。讲义哪里没写清楚，学员会用提问投票，比任何内部评审都准。
速查卡是学员逼出来的产物。8月拆出来之前，有位做行政的学员在问卷里写：能不能把"高频操作前三步加报错对照"单独印一张A4，塑封那种。照做之后给两位老学员试读，反馈是"终于不用翻七十页找一句提示词了"。说句不太谦虚的话，现在这份讲义比我当年在厂里见过的任何一份作业指导书都细。就冲那句反馈，第四版熬夜也值。
开头说学员最后能带走的就是讲义，这半年我是真信了。课上的掌声会过去，示范会忘，一份每页都能照着做、改版后还跟得上的讲义，才替你持续干活。要是你也在编讲义，先从给每张截图配文字路径这一条做起，一周就能看到区别。
常见问题
AI培训讲义多少页比较合适？
我们第四版正文压到70页，另配12页速查卡。页数本身不重要，关键是学员能不能在30秒内翻到他要的那一步。超过100页还没有目录索引和速查卡的讲义，基本等于没编完。
讲义该发电子版还是打印版？
两个都给。电子版方便复制提示词、对照彩色截图；线下班里打印版更受欢迎，学员习惯在上面写写画画。有条件的话把速查卡单独打印成一张A4再塑封，这页的留存率在我们班里是最高的。
没有教研经验，第一次编讲义从哪下手？
先把上一期的答疑记录和课堂录音里学员卡住的地方列成清单，按清单倒推章节。先写报错处理和操作路径，案例和理念往后放，甚至可以等第二版再补。别一上来就从概论写起，那是旧讲义的老路。
讲义和课件PPT到底有什么区别？
PPT是讲的人用的提词器，讲义是看的人用的说明书。检验办法很直接：把PPT丢给一个没上过课的人，他大概率看不懂；把讲义给他，他能照着独立做完前三步，这份讲义才算及格。