ARTICLE · 1374653
AI写产品文档,把"大概"消灭掉
PRD里每个模糊词都是将来的扯皮。让AI专找"大概、尽量、尽快",一个都不许活。
大家好,我是彼岸僧。
做过产品的都知道一个定律:PRD 里每个含糊的地方,将来都会变成一场扯皮。
"消息尽量及时送达"——多久算及时?失败怎么办? "支持批量操作"——多少算批量?上限在哪? "异常时给出提示"——什么算异常?提示给谁看?
这些句子写进文档的那一刻,开发、测试、运营对它的理解就已经分叉了。上线那天三方一碰,谁都觉得自己对,然后拿出文档一看:原文确实没说。
产品文档的核心功夫,就是把"大概"翻译成"必须"。
模糊词是将来扯皮的证据
先做个实验,拿你现成的任何一份文档跑一遍:
以下是我们的需求文档(附后)。请只做一件事:列出所有"无法验收"的句子,按出现顺序编号输出。判定标准:一个测试拿着这句话,能不能明确说出"通过"和"不通过"各长什么样。输出格式:编号 | 原句 | 模糊的地方 | 为什么吵起来不要改写,只要清单。跑完你会看到一份完整的"未来扯皮预告"。我第一次跑,38 处。
最常见的三类:
程度词:尽量、适当、合理、友好 无主语句:需通知相关人员(谁?站内信还是短信?) 无边界条件:支持大量数据(多大?多快?)
AI 找这些比你快,因为它没有"我当时想的是"——每个词它都按字面理解,而扯皮时双方也是按字面理解的。
先写用户故事
改法不是逐句打补丁,是先把骨架立对。文档模糊,八成是因为没想清楚用户在什么情况下走到这一步。
功能名:【XX】。请用用户故事把这个功能的骨架立起来:1. 谁(角色要具体到部门/设备型号)/ 想做什么 / 为了什么2. 主流程 5 步以内,每步一句话3. 每步标注:这一步出错的后果是什么(对用户、对业务各一句)4. 不写任何界面细节,只写事第三条"出错的后果"是关键——写不出后果的步骤,说明你还没想清楚它为什么存在。
异常流才是文档的主体
新人写文档,主流程画得漂漂亮亮,异常一笔带过。但开发的工作量、用户的不满、线上的事故,全在异常流里。
让 AI 专门攻击主流程:
主流程(附后)。请逐节点攻击:1. 每个节点列出所有"输入不符合预期"的情况(空、错、超时、重复、部分成功)2. 每种情况回答三件事:系统表现什么 / 用户看到什么 / 状态回滚还是保留3. 把"系统表现"写成可测试的规则: 用"若 X 则 Y"句式,禁用"应该""尽量"4. 输出按节点排序,不做总结跑完你会得到一份比主流程长三倍的异常清单。别嫌长——这份清单每一条,都是在替未来的你挡一次线上事故。

▲ 一份合格的文档,异常栏永远比主流程厚
验收标准倒着写
最后一招,也是最反直觉的:先写"怎么算失败",再写功能。
功能:【XX】。请写出它的失败清单:1. 什么行为出现,这个功能就算没做完(站在测试角度)2. 每条用可执行的语言:给定什么条件/执行什么操作/应看到什么结果3. 至少覆盖:边界值、并发、权限、数据回滚、提示文案五类这个顺序倒过来之后,写作的体会完全不同——你不再是"描述愿景",是"签订合同"。愿景可以诗意,合同不行。

▲ 五类必查的模糊词,每类一句改写示例
写完之后
文档写完,把第一章那份"模糊词清单"再跑一遍。两遍清单之间的差值,就是你这次进步的大小。
三个提醒:
AI 写的文档要人工过"业务真实性"——它不知道你们公司的审批流长什么样,会编一个合理的。编得越合理越危险。 别让 AI 一次写全篇。按"骨架→异常→验收"三段走,每段你都要过目。 存一份"团队专属模糊词黑名单"喂给它,越用越准。
文档这一块,下面的课程卡里有完整的模板章节,从用户故事到验收标准都是现成的。
彼岸僧 · AI + 办公实战连载 09 / 21















































































