多数人用 AI 写发布说明,是让模型把内部变更日志「翻译得客气一点」:把「修复若干 bug」改成「优化体验」,把技术术语换成大白话。结果读起来顺了,客户却还是不知道这次更新跟自己有什么关系。问题不在措辞,而在输入——你给模型的是变更清单,不是影响。面向客户的发布说明要回答的是「这对你意味着什么」,这一步得由你先想清楚,再交给 AI 组织。

先分清内部变更和客户影响

判断:一份变更日志里,只有一部分内容值得写进客户版说明。做法:动笔前把每条变更标成三类——客户能感知的行为变化、客户需要采取的行动、纯内部改动。第三类直接删掉,不要交给 AI 去「美化」,模型没有依据判断哪些内部改动对客户无意义,只会把噪音写得更像卖点。

用「之前—现在—所以」的结构喂给模型

判断:AI 写不出它不知道的影响,影响必须由你提供。做法:每条要发布的变更,先用一句话写清三件事——以前客户怎么做、现在怎么做、省掉了什么麻烦或避免了什么风险。这三句就是提示词的原料。写得越具体,模型越不容易编造收益。

可直接复制的提示词

判断:与其反复口头描述风格,不如把约束写进提示词,一次说清角色、结构、禁忌和输出格式。做法:把上一步整理的三段式信息填入下面模板,按条数增删。

你是面向客户的产品文档编辑。下面是本次发布的变更信息,每条已按「之前—现在—影响」写好。请据此写一份客户版发布说明。

要求:
1. 每条先写客户能感知的变化,再写对他们的实际影响,不写内部实现细节;
2. 需要客户操作的事项单独列出,写清步骤和截止时间(如有);
3. 不使用「重磅」「焕新」「赋能」等营销词,不夸大收益,不承诺未验证的效果;
4. 不确定的影响不要补写,标注「待确认」;
5. 全文控制在 400 字以内,分「本次变化」「你需要做什么」两部分。

变更信息:
(在此粘贴)

逐条核对,删掉模型补出来的因果

判断:模型最常见的错误是给变化安一个听起来合理的理由,比如「为了让操作更流畅,我们调整了导出流程」。做法:拿到初稿后逐句问「这句话有依据吗」,凡是原始信息里没有的因果、数字、时间承诺,一律删除或改成中性描述。涉及计费、数据处理、合规条款的表述,不要依赖模型改写,保留法务或财务确认过的原文。

把「你需要做什么」写成一节

判断:客户最关心的是自己要不要动手,这一节缺失,说明再漂亮也没用。做法:单独成节,用列表逐条写清操作对象、入口位置、是否必须、不做的后果。没有需要客户操作的事项,就明确写「本次更新无需你操作」,不要留空让读者猜。

什么情况下不适用

判断:这套流程适合功能迭代、体验优化、常规维护类发布。以下情况不要用 AI 起草客户说明:涉及安全事件、数据泄露或服务中断的通报;涉及价格、合同条款、退款政策的变更;受监管行业需要固定措辞的披露。这些内容的责任在发布方,措辞偏差可能带来法律或合规风险,应由法务、合规或相关负责人定稿,AI 最多用于内部草稿的语句通顺检查。另外,如果团队没人能核对技术准确性,也不要用——没人能验证的稿子,写得再顺也不该发出去。