القائمة
阶段 5 上线时撰写 release note。面向用户/运营/客服三种受众分别输出。
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
| name | release-note-doc-writer |
| description | 阶段 5 上线时撰写 release note。面向用户/运营/客服三种受众分别输出。 |
| allowed-tools | Read, Write, Bash, Glob |
原文 §8.3 文档撰写类。
status=done 的 features 列表requirement.md 目标写到 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. 失败用户已自动记入名单，运营可补发
校验业务代码与 IDL 契约同步、字段冻结状态是否被破坏。作为 8 维度 code review 的"契约一致"维度，可被 design-checker / code-review-preparer 调用，也可独立运行。
聚合 8 维度 review Agent 的产出，生成统一的 review 报告并写入 reviews/{ts}.md。
当 context/ 下新增/删除文件时，自动更新对应层级的 INDEX.md，避免"孤儿文件"。
按 templates/detail-design.md 模板撰写详细设计文档，包括数据模型、IDL 变更、接口设计、决策、错误处理、监控、灰度等。
运维操作中心（Operations Center）通用适配器——为团队的运营/运维操作（开关、灰度、限流、降级）提供统一调用约定。具体实现按团队接入。
DevOps CLI 通用适配器——把团队的部署/构建/发布命令包装成一致的高层接口。具体实现按团队接入。