那些年我发过的“鬼才懂”更新公告，后来全被AI重写了

一、先看看我干过的蠢事

做SaaS的独立开发者，多多少少都经历过这样的夜晚：代码刚合并完，新版本上线了，用户在群里问“这次更新了什么”，你顺手把commit log粘进公告框——

fix: 修复若干bug
feat: 新增字段
chore: 更新依赖

发出去之后，群里安静了三秒，然后有人问：“所以我能用上什么新功能？”

这就是最常见的失败做法之一：把写给机器看的日志，原样丢给用户看。 commit log的价值在于精确，用户公告的价值在于“这和我有什么关系”。两个语境硬套在一起，结果就是谁都不满意。

第二类失败做法更隐蔽：憋大招式写作。 有的开发者觉得公告代表产品形象，每次更新都要认真写。于是打开文档，想标题、想开头、想配图，写了删删了写，四十分钟过去，正文还停留在“本次更新为大家带来了……”。最后要么草草收场，要么干脆不发了——反正用户会自己发现的，对吧？不会的。

第三类：风格分裂。 心情好时公告写得热情洋溢，加班后写的就是三行冷冰冰的列表。老用户翻一眼历史公告，感觉像在看两个人格在交替值班。再加上中英文版本、邮件版和站内版的格式各不相同，维护成本雪球越滚越大。

这三类做法的共同点是：把一件本该流水线化的重复工作，当成了每次都要“创作”的任务。

二、AI到底能替你做什么

想清楚一件事：更新公告的本质是翻译——把开发者语言翻译成用户价值语言。而翻译，恰恰是AI最擅长的事情之一。

具体拆开看，AI在这条流水线上能接四个活：

1. 读懂你的原始材料。 commit log、PR描述、issue讨论记录，甚至你随手记的几行备忘，直接丢给AI。它不需要你先整理成漂亮的结构，恰恰相反，越乱的原料它越能发挥。

2. 完成“功能→价值”的转换。 “新增webhook重试机制”在开发者眼里是个技术改进，在用户眼里应该变成“回调失败不再丢数据，第三方对接更省心”。这个转换需要站在用户视角重新表述，AI做这个比大多数写完代码已经很疲惫的开发者做得好。

3. 统一口吻和格式。 给AI一份你的公告风格说明（几句话就够），之后每一篇公告它都能按同样的结构输出：一句摘要、几条亮点、影响范围说明。你的公告页从此看起来像个专业团队在维护——哪怕团队只有你一个人。

4. 多版本一键衍生。 同一份更新内容，自动生成站内公告长版、邮件推送中版、社群短文案、英文版。以前要做四次的工作，现在做一次。

三、我的工作流：每次更新只花五分钟

现在我的流程固定成三步：

第一步，攒原料。 版本发布前，把这一周期的commit log导出，加上PR标题和几条关键issue的描述，一股脑存进一个文本文件。不用整理，甚至不用改错别字。

第二步，跑模板。 调用一次大模型API，把原料和我的固定提示词模板一起发出去。几秒钟后拿到结构完整的公告草稿。

第三步，人工过一遍。 重点检查两件事：有没有AI臆造出来的功能描述（偶尔会有），以及涉及计费、权限变更这类敏感信息是否表述准确。改完发布，收工。

从“能拖就拖”到“顺手就发”，变化的核心不是AI写得比我好多少，而是这件事的成本降到了我愿意做的水平。

下面是我的提示词模板，可以直接复制使用：

你是一位资深SaaS产品运营，负责为我的产品撰写版本更新公告。

【产品背景】
产品名称：{产品名}
一句话介绍：{产品是做什么的，服务什么用户}
目标用户：{如：中小电商卖家 / 独立开发者}

【写作要求】
1. 将下面的commit log和变更记录翻译成用户视角的价值描述
2. 结构固定为：一句话版本摘要 / 2-4条核心亮点（每条含加粗小标题+两句话说明）/ 其他改进与修复 / 升级提示（如无需操作则省略）
3. 语气：专业但友好，不夸张、不堆 emoji，最多用 1 个
4. 涉及用户操作变更（如需要重新授权、数据迁移）的内容放在显眼位置
5. 不确定的技术细节不要臆造，用一句话概括即可
6. 篇幅控制在 300 字以内
7. 输出末尾额外附上：一条 50 字以内的社群短文案

【本次变更记录】
{粘贴 commit log / PR 描述 / issue 摘要}

模板里的花括号部分按需替换。用下来最关键的是第5条约束——明确告诉AI“不确定就别编”，能显著减少幻觉内容，让人工审核变轻松。

四、前后对比，数字最诚实

以我个人一个迭代周期为例（数据仅为我自己的记录，供参考感受量级）：

总耗时从一小时以上压缩到五分钟以内，而公告的完整度反而是以前的几倍——因为成本够低，那些“不值得发公告”的小更新也都发出来了。用户侧的感受是产品“一直在活跃进步”，这对留存的价值，写不进代码但实实在在存在。

至于成本，调一次大模型API生成公告，花费低到几乎可以忽略——具体价格以你所用模型的官网价格页为准。坦白说，这个场景连旗舰模型都不一定需要，一个性价比型模型就足够胜任这类结构化写作任务。

五、给刚开始的人三条建议

1. 先固化模板，再谈自动化。 提示词模板调顺了，再接入CI/CD在发版时自动触发，顺序别反。
2. 敏感内容人工兜底。 涉及价格、权限、数据变更的表述，永远自己最终确认一遍。
3. 把历史公告喂给AI。 攒几篇你满意的人工润色版作为参考样例，AI的风格贴合度会明显上升。

如果你还没有顺手的模型API来跑这条流水线，可以看看这个平台，注册就能开始接入各类模型：https://api.thistoken.ai/register

更新公告这件小事，值得从“想起来才做”变成“顺手就做”。

---

不想折腾多家供应商的接入差异？在 https://api.thistoken.ai/register 注册，用一个 base_url 调用所有模型。