| name | release-note-doc-writer |
| description | 阶段 5 上线时撰写 release note。面向用户/运营/客服三种受众分别输出。 |
| allowed-tools | Read, Write, Bash, Glob |
Skill: release-note-doc-writer
原文 §8.3 文档撰写类。
输入
- features.json
status=done 的 features 列表
- 当前需求的
requirement.md 目标
- commit 范围
输出三个版本
写到 requirements/{p}/{r}/release-notes.md:
# Release Note — {req-id}
## 给开发者(technical)
- 新增 `POST /coupon/grantByTag`(向后兼容)
- IDL 字段:新增 `tag_rule_json` / `estimated_users`
- DB 新表:`coupon_grant_task` / `coupon_grant_dead_letter`
- 升级要点:客户端 SDK 无须升级;服务端按 detail-design.md §11 灰度
## 给运营(functional)
- ✨ 新功能:可按用户标签一次性发券(最多 1w 用户)
- ⚙️ 配置入口:营销后台 → 发券 → 选"按标签"
- ⏳ 任务处理时间:通常 5-30 秒
- ❓ 常见问题:超过 1w 用户怎么办?需拆分任务
## 给客服(user-facing)
- 用户咨询"为什么没收到券" → 回复模板:
1. 检查用户是否在活动范围
2. 提供 task_id 给运营排查
3. 失败用户已自动记入名单,运营可补发
反模式
- ❌ 三个版本写成同一份(受众错位)
- ❌ release note 缺 rollback 步骤摘要