pm-release-noteslisted
Install: claude install-skill iDWong/pm-skills
> **流程位置**:`pm-master` 13 阶段流程的**阶段9 发版说明**,也可单点直接调用。
> 流程内落盘路径 `docs/release-notes-{产品名}-{版本}.md`(流程门禁按 glob 匹配,命名带产品名/日期是正常的)。
> **本技能是纯对话输出不写文件**,流程内使用时由流程代写到该路径。
# 发版说明撰写
## 支持两种受众版本
1. **面向用户(外部)**:App更新说明、产品公告、营销导向
2. **面向团队(内部)**:Changelog、技术变更记录、部署说明
## Step 0: 主动扫描项目上下文(必须第一步,不要等用户提供)
**不要等用户手动描述需求,先主动用工具扫描项目,找到已有文档后再开始工作。**
### 扫描顺序(优先级从高到低)
| 优先级 | 文件类型 | Glob 查找方式 |
|--------|---------|-------------|
| 最高 | 需求说明书 | `Glob("**/*需求*说明书*.md")` / `Glob("**/*spec*.md")` / `Glob("**/*requirement*.md")` |
| 高 | 设计方案 | `Glob("**/*设计*方案*.md")` / `Glob("**/*系统设计*.md")` / `Glob("**/*design*.md")` |
| 高 | 功能清单 | `Glob("**/*功能*清单*.md")` / `Glob("**/*功能清单*")` / `Glob("**/*feature*.md")` |
| 高 | CHANGELOG | `Glob("**/CHANGELOG*.md")` |
| 中 | README | `Glob("**/README*.md")` |
| 低 | 路由配置 | `src/router/modules/` |
| 低 | 项目代码 | `src/views/`、`src/api/`、`src/mock/` |
### 扫描完成后
1. **汇报找到了哪些文档**(文件路径 + 一句话说明内容)
2. **直接基于文档内容开始工作**,不需要用户再重复描述
3. **如果没找到任何文档**,再用 AskUserQuestion 向用户询问必要信息
4. **如果文档内容不足以完成任务**,只询问缺失的部分,不要重复问已有的信息
## 工作流程
### 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]
🐛 问题修复
- 修复了[描述问题场景,如"某些情况下页面白屏"]的问题
感谢您的使用和反馈,如有问