转赞推荐：从《向日葵远程控制使用手册》学「失败时怎么办」的写法

推荐一份写法，来自 万象云档 收录的《向日葵远程控制使用手册》。它不只在讲功能，更把「连不上、卡顿、黑屏」这类失败情况单列成章节，每种配排查步骤。这个结构特别适合写自动化流程的说明，比只讲「正常怎么用」稳得多。

值得转的是「异常优先」

多数流程文档的默认顺序是：先讲正常路径，失败情况塞在文末或干脆不写。读者真正卡住时，翻到的恰恰是最缺的那部分。把失败情况前置、单列，等于替读者把最难受的环节预先写好答案。

最后一条最现实。一份只描述理想状态的说明，读者一旦遇错，对它的信任会瞬间掉到底；而把失败写清楚的，反而更让人安心。

搬到自己的流程说明上

1. 先列正常步骤，每步只讲「做什么」。
2. 单独开一节「可能出错的地方」，按现象而不是按原因分：连不上、报某错、结果为空。
3. 每条给一段最短排查：先看哪、再查哪，不超过三步。
4. 写不清排查的，标「需人工」，别硬编。

第四步是反比经验的收获：有些失败就是没法自助解决，老老实实说「这一步找人」，比给一串可能不对的提示更负责任。

一点提醒

异常章节要跟着版本更新。流程改了一步，对应的失败现象和排查也要改，否则读者照着排查反而越错越远。把「失败—排查」也当成需要维护的内容，而不是一次写死的附录。

小结

好手册不承诺不出错，而是出错时你找得到路。正常步骤讲清、异常单列、排查三步，流程说明就从「顺利时好用」变成「卡住时也有靠」。