# Pm Release Notes

> 产品发版说明撰写技能。适用场景：(1) App Store/应用市场更新说明，(2) 对外公告发版说明，(3) 面向用户的功能更新介绍，(4) 内部发版变更记录，(5) 用户说「写发版说明」「更新日志」「版本更新」「changelog」「上线公告」时触发

- Skill: `wang-q-l/pm-release-notes` (Agent Skill)
- Install (CLI): `npx skillmds@latest add wang-q-l/pm-release-notes`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wang-q-l/pm-release-notes/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: wang-q-l (https://skillmd.com/u/wang-q-l)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wang-q-l/pm-release-notes

---


# 发版说明撰写

## 支持两种受众版本

1. **面向用户（外部）**：App更新说明、产品公告、营销导向
2. **面向团队（内部）**：Changelog、技术变更记录、部署说明

## 工作流程

### Step 1: 采集版本信息

用 AskUserQuestion 收集：

- 版本号？
- 主要更新内容（功能列表）？
- 受众（用户/开发团队/运营）？
- 发布渠道（App Store/微信公众号/内部系统）？
- 有无重要Bug修复或Breaking Change？

### Step 2: 对外用户版本

**写作原则：**

- 用用户语言，不用技术术语
- 突出用户收益，而非功能描述
- 语气友好、简洁，控制在300字以内
- App Store 说明需简短（100-200字）

#### 模板A：App Store 更新说明

```
v[X.X] 更新内容

[简短的整体描述，1-2句]

✨ 新功能
- [用户语言描述功能，聚焦用户收益]
- [新功能2]

🔧 优化改进
- [改进点，如"优化了搜索速度，让您更快找到想要的内容"]
- [改进点2]

🐛 问题修复
- 修复了[描述问题场景，如"某些情况下页面白屏"]的问题

感谢您的使用和反馈，如有问题请联系[联系方式]。
```

#### 模板B：产品公告（微信/官网）

```markdown
# [产品名] [版本号] 正式发布

[开头1-2句话，说明本次更新的核心价值/主题]

---

## 本次更新亮点

### [功能1名称]

[配图建议: 截图或示意图]

[描述用户能做什么，带来什么价值，2-3句话]

**如何使用**：[简短的操作引导]

---

### [功能2名称]

[同上格式]

---

## 其他优化

- [优化点1]：[简短描述改进效果]
- [优化点2]：[简短描述改进效果]
- 修复了[X个]已知问题

---

**如何升级**：[App端：前往应用商店更新 / Web端：刷新页面即可]

感谢每一位用户的陪伴与反馈，[下一步的期待或展望]。

[产品团队] | [日期]
```

### Step 3: 内部技术 Changelog

```markdown
# Changelog

## [版本号] - [发布日期]

### Added（新增）

- feat: [具体功能描述] ([issue/PR编号])
- feat: [功能2]
- feat: [功能3]

### Changed（变更）

- refactor: [变更描述] - 影响：[影响范围]
- style: [UI/样式变更]

### Deprecated（废弃警告）

- [接口/功能X] 将在 v[X+1] 中移除，请迁移到 [替代方案]

### Fixed（修复）

- fix: [Bug描述] ([issue编号])
- fix: [Bug2描述]

### Security（安全）

- security: [安全修复描述]

### Breaking Changes（破坏性变更）

⚠️ **需要迁移操作**

- [变更描述]
- **迁移方式**：[具体步骤]

---

## [上一版本号] - [日期]

...
```

### Step 4: 内部发版通知（钉钉/飞书/邮件）

```markdown
**[产品名] v[X.X] 已发布上线** 🚀

**上线时间**：[日期时间] **版本号**：v[X.X] **发布环境**：生产环境

---

**本次主要更新：**

1. [更新1]
2. [更新2]
3. [Bug修复：X个]

---

**需要关注：**

- ⚠️ [需要特别说明的注意事项，如有数据库变更、配置更新等]
- 相关业务方：[@相关人员]

**回滚预案**：[是否有回滚方案，联系人]

如发现问题请及时联系：[联系方式]
```

## 写作要点

### 用户版本写作技巧

**把功能描述转化为用户收益：**

- ❌ "新增批量导出功能"
- ✅ "批量导出报告，一次操作搞定月度总结"

**避免的表达：**

- 避免：性能优化、架构升级、代码重构（用户不关心）
- 改为：加载更快了、更稳定了

**用数据说话：**

- ✅ "搜索速度提升 60%"
- ✅ "减少了 80% 的重复操作步骤"

### 版本号规范（语义化版本）

- **主版本 X.0.0**：不兼容的重大变更
- **次版本 X.Y.0**：向后兼容的新功能
- **修订版 X.Y.Z**：向后兼容的问题修复