一句话: 用户手册按任务写,不按功能写:先列出新用户最先要完成的十个任务,每个任务给前置条件、操作步骤、成功标志和排查路径。AI 起草很快,但每条步骤必须有人对着真实界面走一遍 — 写错的手册比没有手册更毁信任。
很多用户手册看起来很完整,但用户还是不会用。
原因是它按功能写,而不是按用户任务写。用户不关心"系统有哪些模块",他关心"我现在怎么完成这件事"。按功能写的手册是产品团队的自我介绍,按任务写的手册才是给用户的说明书。
第一步:先列任务,再动笔
产品是:[产品说明]。 目标用户是:[用户]。 请帮我列出用户第一次使用时最需要完成的 10 个任务。 每个任务说明前置条件和完成标准。
这步是地基。AI 列出的任务清单要用真实行为核一遍:客服被问得最多的是什么、用户卡在哪一步流失,按真实频率重排。新手最常犯的错是照着产品导航栏列任务 — 那是地图,不是路线。比如协作工具,"创建第一个项目并邀请一个同事"就是比"了解项目管理模块"好的任务:前者有完成标准,后者没有。
第二步:新手引导只服务第一次成功
请为这个产品写新手引导。 要求:从用户第一次登录开始,按步骤说明如何完成第一个关键任务。 语气简单,不使用内部术语。
新手引导的目标只有一个:让用户尽快完成第一次成功操作。别在引导里塞产品理念和全功能导览,用户没尝到甜头之前,介绍越多流失越快。另外盯紧 AI 输出里的用词:界面上叫"工作台",引导里就不能叫"控制台" — 一个词对不上,新用户就开始怀疑自己打开方式不对。引导写完做个最便宜的验证:找两个新用户从头走一遍,记录他们在哪一步停下来问人 — 那一步就是要改的。
第三步:操作文档,六段结构
请为这个功能写操作说明。 结构:适用场景、前置条件、操作步骤、成功标志、常见错误、下一步建议。
六段里最常被省略的是"成功标志",但它恰恰最重要:操作完界面长什么样才算成了?没有这段,用户做对了也不确定,照样来问客服。前置条件同理 — 一半的"教程跑不通"是用户根本不满足开始条件,而文档没说。"常见错误"一段也别写成免责声明,要写用户真会犯的错:漏选必填项、权限不够、文件格式不对,每条都配上解法。
第四步:排查文档,写成决策路径
用户遇到问题:[问题]。 请写一段故障排查文档。 包括:可能原因、检查步骤、解决办法、何时联系人工支持。
排查文档的好坏,差在具体程度:
| 差的写法 | 好的写法 |
|---|---|
| 检查网络是否正常 | 打开其他网站试试:能打开,继续下一步;打不开,先修网络 |
| 确认配置正确 | 对照截图检查 X 设置是否为 Y,不一致就改成 Y 再重试 |
| 如仍有问题请联系客服 | 带上错误提示截图和已尝试的步骤联系客服,入口在 Z |
差别就一条:每一步都有明确的判断标准和分支。"何时联系人工"也要写实在 — 告诉用户带什么信息来,客服才能一次接住,不用再来回问。排查文档还有个隐形读者是客服:路径写成文档后,客服直接发链接就行,不用每次手打一遍 — 这是手册回收成本最快的一条路。
坑:AI 会发明不存在的按钮
AI 写手册最危险的不是写得差,是写得太流畅:它会把"这类产品通常有"的菜单路径、按钮名称编进步骤里,语气笃定得像见过你的产品。铁律:每条步骤发布前必须在真实界面上走一遍,截图必须来自当前版本。另一个坑是版本漂移 — 产品改版后手册没跟上。解法不是更勤快地全量巡检,而是把"改功能必查相关文档"焊进发版流程。还有个低级但高频的坑:手册里的功能名和宣传页叫法不一致 — 用户从广告进来,按宣传页的词搜手册,什么都搜不到。
Glouth 怎么用
写手册、FAQ 和新手引导,用 Glouth Chat。要把手册接进 AI 问答、客服系统或产品内助手,看 Glouth Link;需要稳定开通 AI 订阅,看 Glouth Pay。
FAQ
Q:用户手册和帮助中心是一回事吗? 重叠但不同:手册偏体系,按任务把产品讲一遍;帮助中心偏检索,用户带着具体问题来查。小团队先做帮助中心,手册从高频文档里长出来。
Q:截图要做什么处理? 两件事:脱敏(账号、订单号、真实数据全部打码或换成演示数据)和标注(箭头圈出要点的位置)。截图里露真实用户信息,文档就成了泄露源。
Q:AI 写的步骤怎么验证最快? 找一个没用过这个功能的人,只看文档操作一遍,你在旁边只记录、不指导。卡住的每一处都是文档要改的地方 — 作者自查没用,作者看不见自己的盲区。
Q:产品更新快,手册跟不上怎么办? 接受"部分滞后"是常态,但要分级:核心任务路径的文档必须随版本更新,边角功能允许晚一点。把文档检查放进发版清单,比事后补救省力。
最后提醒
用户手册不是给产品团队看的,而是给第一次使用的人看的。按任务写,少用术语,写清成功标志和排查路径,再让真人走查一遍,这样的手册才真正能给客服减负。
想直接上手?
这篇讲的活,打开 Glouth Chat 就能干:GPT-5.5 / Claude 等模型中文直接用,不用翻墙、不用海外卡。想给自己的 ChatGPT 账号开 Plus 的看国内充值指南;要把 AI 接进自己的工具,走 Link API。