⚡

产品更新日志撰写Skill product-changelog

这个技能专注于编写高效、用户友好的产品更新日志和发布说明，帮助团队与用户沟通新功能、改进和修复。内容包括用户语言转换、视觉设计集成、版本管理策略和分发渠道优化，旨在提升产品透明度和用户参与度。关键词：产品更新日志、发布说明、用户沟通、SEO优化、产品运营、视觉设计、版本控制、分发策略。

产品运营 0 次安装 2 次浏览 更新于 3/12/2026

name: 产品更新日志 description: “用户实际阅读的产品更新日志和发布说明。涵盖分类、用户语言、视觉元素和分发渠道。用途：发布说明、更新日志、产品更新、功能公告、版本管理。触发词：更新日志、发布说明、产品更新、版本说明、新增内容、功能公告、产品更新日志、更新记录、发布公告、版本发布、产品发布、发布笔记” allowed-tools: Bash(infsh *)

产品更新日志

通过 inference.sh CLI 编写用户阅读并关心的更新日志和发布说明。

快速开始

curl -fsSL https://cli.inference.sh | sh && infsh login

# 生成功能公告视觉图
infsh app run falai/flux-dev-lora --input '{
  "prompt": "干净的产品用户界面截图模拟，现代仪表板界面显示新的分析图表功能，浅色模式，简约设计，专业SaaS产品",
  "width": 1248,
  "height": 832
}'

安装说明： 安装脚本 仅检测您的操作系统/架构，从 dist.inference.sh 下载匹配的二进制文件，并验证其 SHA-256 校验和。无需提升权限或后台进程。提供 手动安装和验证。

条目格式

良好条目的结构

### 新增：报告批量导出 📊

您现在可以从任何报告视图一次性导出多达 10,000 行数据。
选择您的行，点击导出，并选择 CSV 或 Excel 格式。

之前限制为每次导出 500 行。

![报告工具栏中的批量导出按钮](screenshot.png)

结构： 分类标签 -> 用户标题 -> 您现在可以做什么 -> 如何做 -> 发生了什么变化 -> 视觉元素

用户语言

❌ 内部语言：
"实施了导出服务的批处理队列"
"重构了 ReportExporter 类以支持分页"
"修复了 CSV 序列化中的错误 (PR #4521)"

✅ 用户语言：
"您现在可以从任何报告一次性导出多达 10,000 行数据"
"报告在过滤大型数据集时现在加载速度快 3 倍"
"修复了导出 CSV 文件缺少列的问题"

规则：

  • 写用户可以做什么，而不是您构建了什么
  • 以 “您现在可以…” / “报告现在…” / “修复了…的问题” 开头
  • 包含好处，不仅仅是机制
  • 使用现在时

分类

标准分类

分类 颜色 图标 用途
新增 绿色 ✨ 或 🆕 全新功能或能力
改进 蓝色 ⚡ 或 🔧 现有功能的增强
修复 黄色/橙色 🐛 或 🔨 错误修复
移除 红色 🗑️ 或 ⚠️ 已弃用或移除的功能
安全 紫色 🔒 安全补丁

分类规则

  • 新增 = 用户之前完全无法做的事情
  • 改进 = 用户之前可以做的事情，现在更好/更快/更容易
  • 修复 = 之前已损坏的东西，现在正常工作
  • 不要使用 “更新” — 它没有意义。是改进还是修复？

版本编号

语义化版本控制 (SemVer)

主版本.次版本.修订版本
  3   .  2  .  1
组件 何时递增 示例
主版本 重大变更、主要重新设计 2.0.0 -> 3.0.0
次版本 新功能、向后兼容 3.1.0 -> 3.2.0
修订版本 错误修复、小改进 3.2.0 -> 3.2.1

基于日期的版本控制

2026-02-08  或  2026.02.08  或  2026年2月8日

适用于持续部署的 SaaS 产品。

更新日志页面结构

# 更新日志

## 2026年2月8日

### 新增
- **报告批量导出** — 一次性导出多达 10,000 行数据。[了解更多 →](链接)
- **深色模式** — 从设置 > 外观切换深色模式。

### 改进
- **仪表板加载** — 仪表板在大型数据集上现在加载速度快 3 倍。
- **搜索** — 搜索结果现在包括归档项目。

### 修复
- 修复了导出 CSV 文件缺少列标题的问题。
- 修复了日期选择器显示错误时区的错误。

---

## 2026年2月1日

### 新增
- **API Webhooks** — 在您的账户中发生事件时获取通知。

### 修复
- 修复了电子邮件通知延迟最多 2 小时的问题。

视觉更新日志

何时添加视觉元素

变更类型 视觉元素
新用户界面功能 新功能的截图
用户界面重新设计 前后对比
新工作流程 分步截图或短视频
性能改进 显示改进的图表
复杂功能 动画 GIF 或视频演示

生成视觉元素

# 功能截图（如果您有应用运行，使用代理浏览器）
infsh app run infsh/agent-browser --input '{
  "url": "https://your-app.com/new-feature",
  "action": "screenshot"
}'

# 前后对比
infsh app run infsh/stitch-images --input '{
  "images": ["before-screenshot.png", "after-screenshot.png"],
  "direction": "horizontal"
}'

# 带标注的截图
infsh app run bytedance/seededit-3-0-i2i --input '{
  "prompt": "在右上角区域的导出按钮周围添加红色圆圈高亮",
  "image": "screenshot.png"
}'

# 功能公告横幅
infsh app run falai/flux-dev-lora --input '{
  "prompt": "干净现代的产品公告横幅，渐变蓝到紫背景，抽象几何形状，专业SaaS美学，宽格式",
  "width": 1248,
  "height": 832
}'

重大变更

重大变更需要特别处理：

### ⚠️ 重大：API v2 端点已弃用

**发生了什么变化：** API v1 端点将在 2026年3月15日停止工作。

**您需要做什么：**
1. 更新您的 API 调用以使用 v2 端点（[迁移指南 →](链接)）
2. 更新身份验证以使用 Bearer 令牌而不是 API 密钥
3. 在 3月15日 前测试您的集成

**时间线：**
- 现在：v2 端点可用，v1 仍然工作
- 3月1日：v1 返回弃用警告
- 3月15日：v1 停止工作

如果您需要迁移帮助，请联系 support@company.com。

分发渠道

渠道 格式 何时
更新日志页面 完整详情，所有条目 每次发布
应用内通知 1-2 行摘要 新功能、重大变更
电子邮件 精选亮点、视觉元素 主要发布（每月/每季度）
博客文章 深入探讨与背景 大型发布
社交媒体 单个功能亮点 显著功能
Slack/Discord 简短公告 如果您有社区

社交媒体片段格式

🆕 [产品] 中的新增功能：[功能名称]

[1-2 句描述您现在可以做什么]

[截图或演示视频]

立即尝试 → [链接]

写作技巧

要做的

  • 将相关变更分组在一起
  • 以最大/最受欢迎的变更开头
  • 链接到复杂功能的文档
  • 包含谁请求了它（“根据流行请求：”）
  • 显示重大变更的迁移路径
  • 为每个条目添加日期

不要做的

  • 不要说 “各种错误修复” — 列出具体修复或跳过
  • 不要包含内部引用（PR 编号、工单 ID、分支名称）
  • 不要使用 “更新了 [功能]” 而不说明如何更新
  • 不要列出无关紧要的变更（依赖项更新、内部重构）
  • 不要提交转储 — 一个更新日志条目可能代表多次提交

更新日志频率

产品类型 频率 备注
SaaS（持续部署） 每周批量 将一周的变更分组
SaaS（主要功能） 每个功能发布 带博客文章
版本化软件 每个版本发布 绑定到 semver
API 每个版本 + 弃用通知 包括迁移指南
移动应用 每个应用商店发布 匹配商店列表 “新增内容”

常见错误

错误 问题 修复
开发者语言 用户不理解 写用户可以做什么
“错误修复和改进” 零信息 列出具体修复
无日期 无法辨别什么是新的 为每个条目添加日期
无视觉元素 用户跳过文本 截图主要功能
重大变更被埋没 用户发现太晚 突出警告 + 时间线
提交日志作为更新日志 嘈杂、无帮助 策划和重写

相关技能

npx skills add inference-sh/skills@ai-image-generation
npx skills add inference-sh/skills@prompt-engineering

浏览所有应用：infsh app list