教程看着很完整，读者却卡住了？让 AI 按角色逐步走查
一篇教程写着“上传图片，调整顺序，点击发布”，作者觉得只需三步。第一次使用的人可能连上传入口都找不到，只读成员也根本没有发布按钮。让 AI 帮忙检查操作说明时，可以暂时放下文字是否顺畅，先问每一种读者能否从当前状态走到下一步。
AI生成概念配图
把角色和起点写在教程前面
Google 的官方文档风格指南建议，在操作步骤中先说明任务发生的位置，并提前提供读者需要的准备信息；必要时写出操作后的结果。下面的角色走查是作者基于这些原则设计的编辑方法，目的是找文档缺口，不把模型模拟当作真实使用测试。
设想虚构产品“光盒相册”有管理者、编辑者与访客三类角色。当前教程面向编辑者，目标是上传照片并保存为草稿。开始状态是已经登录且进入正确相册，上传文件已准备好。把这些条件写清楚，才能判断“选择照片”这一句是否足以让读者继续。
每一步问四件事
当前位置：读者在哪个页面或面板，怎样确认没有走错。
可用条件：当前角色能否看到并使用该功能，需要先准备什么。
具体动作：点什么、填什么，选项是否必须作出决定。
可见结果：成功后出现什么，接下来从哪里继续。
例如原稿写“上传后保存”，AI 可以指出：没有交代上传入口所在位置，也没有说明上传完成的标志。编辑应回到真实产品补充这些信息。若没有界面证据，就保留“上传入口待核实”，不要让 AI 编一个听起来合理的“右上角云朵图标”。
角色变化时，不要强行走同一条路
假如访客只能浏览，教程应该在准备部分提示“需要编辑权限”，并说明向谁申请或使用哪份只读说明。不能把访客看不到的按钮写成“如果没有，请多刷新几次”。管理者拥有更多菜单，也不意味着适合把管理者截图直接当成所有人的操作路径。
作者建议先选一个主要读者完成整条路径，再检查其他角色会在哪里停止。角色分支太多时，可以拆成独立说明，不必把每一步都堆满“如果你是某某”。这有助于读者始终知道当前段落是否适用于自己。
给 AI 一段受约束的走查任务
可复用模板：下面是操作说明、已核实界面信息和角色权限。请从【角色】的【起始状态】开始，逐步检查当前位置、所需条件、具体动作和可见结果。只使用提供的信息，不假设隐藏菜单。每发现一个缺口，说明读者为什么无法继续，以及作者需要补查什么。暂不改写整篇，也不要声称实际点击或完成了操作。
检查范围还可以加入空相册、上传中断和重复文件等情况，但只处理与这份说明有关的分支。第一次上手教程不必同时承担所有故障排查；可以把异常指向单独的帮助页，并核对链接确实解决对应问题。
最后让一个人照着做
AI 提供的是候选缺口清单。最终仍应找符合目标角色的人，在测试环境按说明操作，记录他停在哪里、问了什么、实际看见什么。尽量让观察者先不解释，否则很容易用口头补充掩盖文档缺失。
修改后只重查受影响的步骤与相邻衔接，并标记适用的产品版本。若界面已经改变，旧截图再清晰也可能误导。好的操作说明让读者知道自己在哪、下一步做什么，以及怎样确认完成；角色走查帮助作者发现那些因过于熟悉产品而省掉的信息。
