该技能用于撰写产品更新日志和发布说明,目标是让用户愿意阅读并理解变更内容。
用途:面向 SaaS、版本化软件、API、移动应用等产品,产出结构化、面向用户的更新说明。
主要能力:
- 条目结构:分类标签 → 面向用户的标题 → 现在能做什么 → 怎么做 → 变化点 → 配图。
- 变更分类:New(全新功能)、Improved(既有功能增强)、Fixed(缺陷修复)、Removed(弃用或移除)、Security(安全修补)。规则强调 New 是此前完全做不到的事,Improved 是原本能做但更好,Fixed 是原本坏了现在正常,并避免使用无意义的“Updated”。
- 面向用户措辞:写用户能做什么,而非你构建了什么;以“You can now…”“Reports now…”“Fixed an issue where…”开头;用现在时,包含收益而非仅机制;不写内部语言、PR 编号、工单 ID、分支名。
- 版本编号:SemVer(MAJOR.MINOR.PATCH)或按日期编号,适用于持续部署的 SaaS。
- 更新日志页面结构:按日期分节,下按分类列出条目,可附链接。
- 配图:新 UI 功能用截图,重设计用前后对比,新流程用分步截图或短视频,性能提升用图表,复杂功能用动图或视频。
- 破坏性变更:需特殊处理,说明改了什么、用户需做什么、时间线,并给出迁移指南与支持联系方式。
- 分发渠道:更新日志页面、应用内通知、邮件、博客、社交媒体、Slack/Discord。
- 更新频率建议:SaaS 连续部署按周批处理,重大功能按功能发布,版本化软件按版本,API 按版本加弃用通知,移动应用按应用商店发布。
- 写作提示与常见错误:归组相关变更、突出最重要的变更、为复杂功能链接文档、标注“应众请求”;不要写“各种缺陷修复”,不要列没人关心的变更,不要把提交日志当更新日志。
使用方式:需先安装 belt CLI 技能:npx skills add belt-sh/cli,并执行 belt login。可用命令如 belt app run falai/flux-dev-lora 生成功能公告视觉、belt app run infsh/agent-browser 截取功能截图、belt app run infsh/stitch-images 生成前后对比、belt app run bytedance/seededit-3-0-i2i 生成标注截图等。相关技能可用 npx skills add inference-sh/skills@ai-image-generation、npx skills add inference-sh/skills@prompt-engineering 添加,并可用 belt app list 浏览所有应用。
限制:资料未提供该技能的授权、价格、平台兼容性或效果保证等信息,暂未提供。