第一次写软件说明书，写完后怎么复盘才不白改

装完一台新路由器，第次盒子里那张快速安装单只有四步：插电源、写软写完接网线、明书连默认 Wi‑Fi、后复打开浏览器输入管理地址。不白第一次装机的第次人往往在第三步停住——手机连上了默认 Wi‑Fi，可浏览器输入 192.168.1.1 后只得到一个“无法访问此网站”。写软写完这时你翻回安装单，明书发现上面根本没写“要先确认手机没有切回移动数据”。后复于是不白你改了一版，加了一行字。第次这一行字，写软写完就是明书复盘真正该盯的东西。

说明书步骤写法的后复复盘，不是不白把稿子再读一遍、改几个错别字，而是回到“第一次上手的人会卡在哪”这个位置，把卡点一条条找出来。下面按第一次写复盘的人的实际动作顺序讲。

先翻出那张被划过的纸或截过图的屏幕

复盘第一件事不是打开文档，而是找证据。把测试时用的那张打印稿、那几张手机截图、聊天记录里同事问你的那句“这一步点哪个按钮”翻出来。第一次写复盘的人常犯的错，是凭记忆改稿，结果改的全是自己觉得不顺的地方，真正让人停住的按钮却漏了。

具体做法：

1. 把纸质稿上的圈画、箭头、问号逐个数出来，每一个圈对应一个卡点。

2. 截图按步骤编号重命名，比如“步骤3-连上WiFi后打不开页面”。

3. 找一位没参与写作的人，让他照稿操作一遍，你只记录他停下来的秒数和位置，不解释。

这一步的产出是一张卡点清单，不是修改稿。清单上每条写清：第几步、什么物件或按钮、停住时的现象。比如“步骤 4，管理页面的‘保存’按钮是灰色，因为上面的‘启用’复选框没勾”。

把“我懂了”翻译成“他照着能点中”

卡点清单出来后，逐条判断性质。第一次做说明书步骤写法复盘的人，最容易把两类问题混在一起：一类是步骤缺了动作，一类是文字没说清对象。

判断标准很直接：读者停住时，是不知道“做什么”，还是不知道“点哪里”。前者补一步，后者改名词。

举例。原文写“进入设置页面，配置网络参数”。“配置网络参数”属于没说清对象，读者不知道点哪个标签页。改成“点顶部‘网络设置’标签，在‘上网方式’下拉框里选‘自动获取 IP’”，动作和按钮都落地了。再比如原文写“必要时重启设备”，“必要时”属于缺判断标准，改成“如果指示灯由闪烁变为常亮，长按机身后方的复位孔 5 秒”。

改的时候守住一条：一步只做一个动作。把“打开浏览器并输入地址后按回车登录”拆成两句，第一次上手的人才不会在“登录”二字上找密码。

让没写过这份稿的人复述一遍按钮名

改完不算完。复盘要有一个可核验的收口动作：找一个人，只给他修改后的稿子，让他指着实物或界面，把每一步的按钮名念出来。念错的地方，就是这轮复盘没改到的地方。

这个动作比“你觉得清楚吗”有用得多。人会说“清楚”，但念不出“复位孔”在哪。念的过程里，你会听到“这个‘确认’是弹窗里的还是页面底部的”这类问题，这正是说明书步骤写法复盘该抓的细节。

如果条件不允许找人，退一步：自己隔一天再照稿操作一次，用手机录屏。回放时看自己的手指在哪一秒犹豫。犹豫超过两秒的位置，回到卡点清单补一条。

复盘记录只留三列，下次直接接着改

最后一件事是留痕。第一次复盘的人往往改完就关文档，下次换人接手又从头猜。建议在文档末尾或单独的表格里留三列：步骤号、卡点现象、改后动作。不写心得体会，不写“优化表达”这种没法核对的描述。

比如：步骤 5｜扫码后提示“证书无效”｜补一句“点‘高级’→‘继续访问’”。三列足够，下次谁接手都能顺着改。复盘记录本身也要能被执行，这是判断它有没有白写的标准。

回到开头那张路由器安装单。真正值得复盘的，不是四步写得够不够简练，而是第三步到第四步之间那个没人提醒的“关掉移动数据”。把这类卡点找出来、改到按钮级别、再让人念一遍，说明书步骤写法的复盘才算走完一轮。下一版交付前，先问自己：卡点清单还在不在，三列记录填没填。