release-notes 是把工单、内部日志或产品资料转成用户更新说明的 Skill。它说明改了什么、影响谁、为何值得关心,并突出需要用户操作的变化。
先确认哪些内容确实交付,再分新功能、改进、修复、破坏性变更和弃用。需求文档写了不等于产品上线,未覆盖的用户也不能笼统写成“所有人现在都能用”。
技术词可以翻成用户影响,但不能顺手发明收益。原文把缓存改动示范成“快 3 倍”,没有测试材料就不能沿用这个数;修复也要描述实际症状,而不是承诺再不会失败。
需要迁移或调整接口的事项应告诉用户做什么、何时做。适合从工程记录写出可理解的发布稿;保存草稿、发布公告与实际升级是不同动作,本文没有替任何产品发公告。