产品迭代说明发出去之后,用户最常问的一句是:这次到底改了啥?不是用户不读公告,而是很多说明把开发语言直接翻译成了另一种开发语言。用 Notion AI 起草时尤其容易出现这种情况,因为 AI 会默认概括输入内容,却不会主动判断哪些信息对普通用户有意义。要解决这个问题,关键不在文笔,而在提示词怎么把用户视角固化成硬性约束。

为什么直接让 Notion AI 写迭代说明容易变成自嗨
很多人把迭代说明当成开发记录的删减版,给 Notion AI 的输入是:优化登录模块,新增报表导出,修复若干问题。AI 收到这种缺少场景的信息,只能输出:本次更新优化了登录模块,新增报表导出功能,修复了已知问题。这句话看起来没毛病,但用户看完仍然不知道登录到底改了什么,报表导出在哪里操作,修复的问题是否和自己有关。
根本原因是开发侧变更和用户侧体验使用的是两套语言。开发记录关心模块、接口、字段、状态流转,用户只关心自己原来的使用习惯有没有被打破,新功能是否能少做几步操作。Notion AI 不会自动完成这层翻译,除非提示词明确要求它站在普通用户的位置重写每一个变更点。因此,提示词里要做的第一件事不是让 AI 写得更多,而是先规定它必须回答哪些问题。
用用户视角三问搭建提示词主干
比要求 AI 写得通俗更有效的办法,是给每条变更固定一个输出骨架。可以规定:每个用户可见的变更点,都要按照变更前体验、变更后体验、直接收益、需要用户做什么这四个维度展开。这样 AI 就不是自由发挥,而是在回答具体问题,输出稳定性会明显提高。
下面是一个可直接使用的基础提示词。
你是一名产品文案,读者是普通用户,不是开发人员。 请根据下面的开发侧变更记录,写一份产品迭代说明。 对每条用户可见的变更,必须按以下格式输出: - 变更前体验: - 变更后体验: - 用户能感知到的收益: - 用户需要做的操作:如果没有就写“无需操作” 不要单独使用“优化”“提升”“修复”这类空泛词,除非后面跟着具体对象和效果。 变更记录如下: 1. 登录模块:session 有效期从 2 小时改为 7 天,记住设备选项默认开启。 2. 报表模块:新增 CSV 导出按钮,支持导出最近 90 天数据。 3. 权限模块:管理员的成员列表入口从左侧菜单移到右上角头像菜单。
这个提示词的重点不是句式多复杂,而是用四个固定问题逼着 AI 把用户不知道的信息补出来。例如登录模块的变化,写清楚前后差异后,用户才能理解为什么登录到一半不再掉线,而不再只看到一句登录体验升级。报表导出的条目则会变成现在可以把最近 90 天数据导出成表格保存到本地,而不是新增导出能力。
如果你希望输出更接近产品公告的语气,还可以在提示词里加入一条:请用第二人称你和用户对话,不要使用我们。这个小约束可以显著减少官方通知腔。
先把变更记录分类,避免把内部改动写给用户
开发侧的变更记录经常混着大量用户不需要知道的内容,比如依赖升级、日志调整、数据库索引优化。这些内容如果直接进入 Notion AI 的输入,AI 很可能一本正经地把它们写成用户说明,结果就是出现调整了底层接口、升级了第三方库这种用户根本无感的条目。
解决方式是在提示词中增加一个前置分类步骤。让 AI 先判断哪些变更用户能直接看到,哪些只能间接感知结果,哪些纯属内部工程调整。对应的处理策略是:直接可见的详细写,间接感知的合并写,纯内部的直接丢弃。
请先对下面的变更记录做分类: A 类:用户能直接看到或操作的功能变化。 B 类:用户能感知到结果、但不一定看到入口的问题修复或性能变化。 C 类:纯内部重构、依赖升级、日志调整,不体现在用户说明中。 输出要求: - A 类条目必须详细写,按“以前-现在-好处-需要操作”四段式描述。 - B 类条目合并成“稳定性与体验修复”模块,每条不超过两行。 - C 类直接丢弃,不要出现在最终说明里。 变更记录: 1. 新增导出报表入口。 2. 修复登录超时后偶发白屏。 3. 升级前端构建工具。 4. 调整成员权限判断逻辑。
这一步相当于在提示词里设置了信息过滤器。它能让 AI 明白,产品迭代说明不是开发日志的翻译版,而是面向用户的变更通知。实际使用中,如果你从 Notion 数据库导出任务列表,建议先把技术任务和用户故事分开,或者让 AI 按上面的分类规则自行过滤。人工只要快速检查一遍分类结果,不用逐字修改文案。
用禁止项和少量示例控制语气
Notion AI 在没有示例时,容易写出一堆营销腔,比如重磅更新、极致体验、全新升级。这些词放在内部周报里还能接受,放到用户看到的迭代说明里就显得很空。要控制语气,需要在提示词里直接列出禁止出现的词,而不是只说写得自然一点。因为自然这个词太抽象,AI 并不能稳定理解你想要的边界。
更可控的做法是同时在提示词里给一到两个正确示例,让 AI 模仿表达密度和句式。比如你可以写:把优化了用户体系,提升了登录体验改写成你现在登录一次可以保持 7 天,不用每天重新输入密码。把导出能力上线改写成现在可以把最近 90 天数据导出成表格保存到本地。这两个示例会把空泛词和具体体验的差距直观展示出来,比任何形容都管用。
语气要求: - 使用第二人称“你”,不要用“我们”。 - 禁止出现:重磅、极致、赋能、闭环、全新升级、重磅上线、史诗级。 - 每条说明必须让用户知道“以前是什么样、现在是什么样、我要不要操作”。 - 不要写“感谢支持”“敬请期待”等仪式化句子。 正确示例: 以前登录状态经常在 2 小时后失效,你需要重新输入密码。现在登录一次可以保持 7 天,常用设备会自动保持登录,无需额外操作。
这个示例片段可以和前面的分类规则、四段式结构合并在一起,形成一个完整提示词。实际使用时不必担心提示词太长,Notion AI 对结构化指令的遵循度通常高于短句。关键是每条指令之间不要互相冲突,比如既要求简洁,又要求按四段式展开,AI 会难以平衡。可以改成:每条不超过 80 字,但必须包含前后变化和是否需要操作。
完整提示词与工作流
把前面的规则组合起来,就能得到一个比较完整的产品迭代说明提示词。你可以把它保存到 Notion 的文档模板中,每次迭代结束后替换变更记录部分。下面是一个整合版本。
你是一名产品文案编辑,读者是普通用户。请根据下面的开发侧变更记录,写一份产品迭代说明。 第一步:分类 A 类:用户能直接看到或操作的功能变化。 B 类:用户能感知到结果但不一定看到入口的问题修复。 C 类:纯内部重构、依赖升级、日志调整。 第二步:输出规则 - A 类按“变更前体验-变更后体验-收益-是否需要操作”四段式写。 - B 类合并成“稳定性与体验修复”,每条不超过两行。 - C 类直接丢弃。 - 全文使用第二人称“你”,不要用“我们”。 第三步:语言限制 - 禁止出现:重磅、极致、赋能、闭环、全新升级、史诗级。 - 不写“感谢支持”“敬请期待”等仪式化句子。 - 每条说明都要落到用户能感知的具体变化,不用模糊动词。 第四步:示例 以前登录状态经常在 2 小时后失效,你需要重新输入密码。现在登录一次可以保持 7 天,常用设备会自动保持登录,无需额外操作。 变更记录: 请把你这次迭代的变更记录粘贴在这里。
实际工作流可以这样安排:迭代结束后,从任务管理工具或 Notion 数据库中筛出用户故事和缺陷记录,拼成一段纯文本,替换提示词末尾的变更记录占位内容。然后让 Notion AI 生成初稿,人工重点检查三件事:分类是否正确、每条是否写清了前后变化、用户需要的操作是否明确。如果 AI 把某个内部改动误判成 A 类,把它移到 C 类或直接删掉,再让 AI 重新生成一次。
这套方法的核心不是让 AI 替你思考,而是用分类、格式、禁止项和示例把思考框架提前固定下来。这样每次生成的内容即便不完全一致,也会保持稳定的用户视角。迭代说明最终要回答的不是我们做了什么,而是你使用的时候会发现什么不同。把这句话写进提示词,比任何高级技巧都更接近问题的本质。