product-changelog

用途

Product Changelog 是一个用于撰写产品更新日志（changelog）和发布说明（release notes）的技能，核心目标是让用户真正阅读并关心这些内容。它通过 inference.sh CLI（belt）运行，并可用于生成功能公告所需的视觉素材。

主要能力

提供更新日志条目的标准结构：分类标签 → 面向用户的标题 → 用户现在能做什么 → 如何操作 → 变化点 → 配图。
提供面向用户的措辞规则，区分内部语言与用户语言，例如将“Implemented batch processing queue for the export service”改写为“You can now export up to 10,000 rows at once from any report”。
定义标准分类及其颜色与图标：New（绿色，✨ 或 🆕）、Improved（蓝色，⚡ 或 🔧）、Fixed（黄/橙色，🐛 或 🔨）、Removed（红色，🗑️ 或 ⚠️）、Security（紫色，🔒）。
提供分类判断规则：New 表示用户此前完全无法做到的事；Improved 表示原本可做、现在更好/更快/更简单；Fixed 表示原本损坏、现在正常。不建议使用含义模糊的“Updated”。
介绍版本号方案：语义化版本（SemVer）MAJOR.MINOR.PATCH，以及日期版本（如 2026-02-08、2026.02.08、February 8, 2026），后者适合持续部署的 SaaS 产品。
给出更新日志页面结构示例，按日期分组，下设 New、Improved、Fixed 等小节。
说明何时添加视觉素材：新 UI 功能用截图、UI 改版用前后对比、新工作流用分步截图或短视频、性能提升用图表、复杂功能用动图或视频演示。
提供生成视觉素材的 belt 命令，包括功能截图、前后对比拼接、带标注的截图、功能公告横幅。
说明破坏性变更的处理方式：明确变化内容、用户需要做什么、时间线，并提供迁移指南与支持联系方式。
列出分发渠道及对应格式与时机：更新日志页面（每次发布，完整细节）、应用内通知（1-2 行摘要，新功能与破坏性变更）、邮件（精选亮点与视觉，重大版本按月/季度）、博客文章（深度背景，大型发布）、社交媒体（单功能亮点）、Slack/Discord（简短公告，若有社区）。
提供社交媒体片段格式与写作技巧（该做与不该做）。
给出不同产品类型的更新频率建议：SaaS（持续部署）每周批量、SaaS（重大功能）按功能发布、版本化软件按版本发布、API 按版本加弃用通知、移动应用按应用商店发布。
列出常见错误及修正方式，例如开发者语言、笼统的“bug fixes and improvements”、缺少日期、缺少视觉、破坏性变更被埋没、把提交日志当更新日志。

使用方式

安装 belt CLI 技能：

npx skills add belt-sh/cli

快速开始需要 inference.sh CLI（belt），安装说明见官方文档。登录：

belt login

生成功能公告视觉素材示例：

belt app run falai/flux-dev-lora --input '{
"prompt": "clean product UI screenshot mockup, modern dashboard interface showing a new analytics chart feature, light mode, minimal design, professional SaaS product",
"width": 1248,
"height": 832
}'

生成视觉素材的其他命令：

# Feature screenshot (if you have the app running, use agent browser)
belt app run infsh/agent-browser --input '{
  "url": "https://your-app.com/new-feature",
  "action": "screenshot"
}'

# Before/after comparison
belt app run infsh/stitch-images --input '{
  "images": ["before-screenshot.png", "after-screenshot.png"],
  "direction": "horizontal"
}'

# Annotated screenshot with callout
belt app run bytedance/seededit-3-0-i2i --input '{
  "prompt": "add a red circle highlight around the export button in the top right area",
  "image": "screenshot.png"
}'

# Feature announcement banner
belt app run falai/flux-dev-lora --input '{
  "prompt": "clean modern product announcement banner, gradient blue to purple background, abstract geometric shapes, professional SaaS aesthetic, wide format",
  "width": 1248,
  "height": 832
}'

适用场景

适用于需要撰写产品更新日志与发布说明的团队，包括 SaaS 产品、版本化软件、API 服务、移动应用等。可用于日常发布说明、重大功能公告、破坏性变更通知以及多渠道分发内容的撰写。

限制

该技能依赖 inference.sh CLI（belt）运行，视觉素材生成需要相应应用与登录。资料未提供具体收费、价格或平台支持范围的更多信息。

技能介绍

用途

主要能力

使用方式

适用场景

限制