产品管理 · 方法论
AI写的文档
你为什么读不下去
评审会上,需求文档投在大屏上——内容都对,但全场沉默。问题不在内容质量,在阅读体验。
你大概经历过这个场景:
评审会上,需求文档投在大屏上。AI生成的,内容齐全——背景、目标、功能清单、验收标准,一个不少。你扫了一遍,又扫了一遍。然后你发现自己在发呆。
不是看不懂。是看不进去。
满屏文字像一堵灰墙,每一句都对,但眼睛就是滑过去。最后有人说:"要不……你口头讲一遍?"
数据复盘报告也一样——AI把数据、结论、建议全铺开了,逻辑没问题,但你盯了三分钟,还是不知道该关注哪个数字。
你可能会想:是不是Prompt写得不够好?再优化一下措辞?
确实有用——内容更准了,背景更清晰了,边界条件也没遗漏。但评审会上大家还是发呆。
因为"准"和"读得下去"是两件事。准确度解决的是"内容对不对",而评审会上的沉默,是"读者能不能快速抓住重点"的问题。
内容对了,为什么还是读不下去
你让AI写一份需求文档,它会怎么做?把所有相关信息铺开——背景、目标、用户故事、功能列表、边界条件、验收标准,一条不漏。
这恰恰是问题所在。
AI天然"求全不求精"。它不做优先级判断,不区分"评审会上必须达成共识的3个关键点"和"补充说明的8条边界条件"。在它眼里,这些信息权重一样。
但人不是这么读东西的。前30秒抓不到重点,后面就全是"扫"而不是"读"。你对着AI文档发呆,不是你能力不行,是那份文档没给你一个"先看这里"的入口。
所以真正要解决的不是"AI写得好不好",而是"人能不能读得进去"。我们团队摸索出三步,从源头治这个问题——不是优化Prompt措辞,而是改变文档的结构和交付形式。
第一步
强制TL;DR前置
什么叫TL;DR?Too Long; Didn't Read——太长了,没看。意思就是"给懒人看的总结"。
做法很简单:在Prompt里加一条硬约束——文档开头必须有一段不超过3句话的结论摘要,回答三个问题:这份文档要解决什么问题、关键决策是什么、读者需要做什么。
改之前,AI生成的需求文档:
需求背景
随着用户规模增长,现有消息推送系统在高并发场景下出现延迟……(后面还有8段)
改之后:
TL;DR:本次迭代将消息推送系统从同步改为异步,预计降低延迟峰值60%(假设场景)。需要评审确认技术方案和排期。
需求背景
随着用户规模增长……
区别在哪?读者打开文档第一眼,就知道"这篇要我干什么"。后面的内容都是支撑这个结论的论据,按需深入就行。
数据复盘报告同理。AI一上来就铺数据,读者翻半天才知道结论。加一个TL;DR——"本周GMV下降12%,主因是新用户转化率跌了8个点,建议排查注册流程"——三句话,读者就知道该不该往下看。
检验一下:翻翻你最近一份AI生成的文档,第一句话能告诉读者"这篇要我干什么"吗?如果不能,问题不在AI,在你的Prompt缺了这条约束。
第二步
图表替代文字
AI写文档有个毛病:特别爱用项目符号。什么都列成bullet,一列七八条,条条之间还有嵌套关系,但它不告诉你。
需求文档里最典型:
• 用户可以通过邮箱注册 • 注册后需要验证 • 手机号验证通过短信 • 邮箱验证通过链接 • 验证失败需要提示 • 手机号已注册 • 邮箱格式错误 |
你看完这7条,脑子里有没有自动把它变成一个表格?大概率有。人处理结构化信息,表格比bullet快得多。
同样的信息,换成表格:
一眼就懂。这就是图表替代的价值。
在Prompt里加约束:涉及对比、枚举、条件分支的内容,必须用表格输出;涉及流程的内容,必须用流程图描述。 AI完全做得到。
数据复盘报告更需要这一步。复盘报告的核心是"指标→变化→归因"的三列对照关系,强制用表格输出,可读性直接翻倍。
检验一下:找一篇你用AI生成的文档,数数有几个连续bullet超过5条的。超过2个,就该改成表格了。
第三步
交付形式从Markdown升级到HTML
前两步解决的是"内容结构"问题。但有一个更底层的问题,很多人没意识到:
Markdown本身就不是给人"读"的格式。
想象一下:一份30页的报告平铺在桌面上,没有目录,没有章节标签,你只能从头翻到尾。这就是Markdown文档在协作工具里的样子。
它是给开发者写技术文档用的,设计目标是"纯文本能看、能转换"。但你的读者是产品经理、运营、业务方。他们在飞书、钉钉里打开一份Markdown文档,没有折叠,没有锚点导航,长文档只能从头滚到尾。
AI默认输出Markdown,因为它学的就是这套格式。但你的读者需要的是"能快速跳转、能折叠展开、能一眼定位"的文档。
解法是什么?给文档加几个"可折叠的抽屉"——不用的先收起来,要用再拉开。具体来说,加三个东西:
这三步听起来技术感很强,但你不需要自己写代码——在Prompt里告诉AI"用这些结构输出"就行。关键是你要意识到:AI生成的Markdown只是半成品,交付形式值得多走一步。
AI负责"对",人负责"读得下去"
三步法的逻辑是一条线:从内容结构,到信息呈现,到交付形式,每一步都在替读者省脑力。
但比三步法更重要的,是一个判断标准:以后每次用AI写文档,你的第一反应不该是"写得准不准",而是"读者打开文档3秒内,能抓住重点吗?"
AI天然不做信息优先级判断——这是人的活,不能外包给AI。
AI负责把内容写对,但"读得下去"这个活,得人来。
你花在Prompt约束上的每一分钟,都在替读者省十分钟。
夜雨聆风