patch-notes — 面向用户更新说明

技能目的

将技术性的变更日志转换为面向最终用户的更新说明，使用非技术语言描述用户可感知的变更，作为发布说明、应用商店更新文案或公告草稿。

参数说明

• [版本号]：可选，指定生成更新说明的版本号。省略时使用最新版本。

分阶段工作流

阶段 1：读取变更日志

• 输入：版本号参数
• 处理：
  1. 使用 Glob 查找 CHANGELOG.md 或 docs/release/changelog*
  2. 使用 Read 读取变更日志，定位目标版本章节
  3. 若未指定版本，取文件顶部最新版本
  4. 提取该版本的全部变更条目
• 输出：目标版本变更条目

阶段 2：提取用户可见变更

• 输入：目标版本变更条目
• 处理：
  1. 过滤纯内部重构、依赖升级、CI 配置等用户不可感知项
  2. 保留新功能、界面变更、行为变更、问题修复
  3. 使用 Grep 识别含用户影响的关键词（UI、API、workflow、performance）
  4. 标注每条变更的受众：所有用户 / 高级用户 / 管理员
• 输出：用户可见变更清单

阶段 3：转换为非技术语言

• 输入：用户可见变更清单
• 处理：
  1. 将技术描述改写为用户视角的收益描述
  2. 例如："feat: 添加导出 CSV" → "您现在可以将数据导出为 CSV 文件"
  3. 例如："fix: 修复登录超时" → "修复了部分情况下登录超时的问题"
  4. 标注是否需要用户操作（迁移、配置变更）
  5. 对 BREAKING CHANGE 用醒目方式提示
• 输出：非技术语言更新说明

阶段 4：生成发布说明

• 输入：非技术语言更新说明
• 处理：
  1. 按新功能、改进、问题修复、注意事项分组
  2. 添加版本号与日期标题
  3. 补充感谢语与反馈渠道
  4. 使用 Write 生成文件 docs/release/patch-notes-{版本}.md
  5. 同时生成简洁版用于应用商店或公告
• 输出：面向用户的发布说明

协作协议引用

• 遵循 .claude/docs/coding-standards.md 编码规范
• 发布说明写入 docs/release/ 目录
• 内容需用户确认后方可对外发布
• 不自动提交

推荐下一步

使用 /changelog 生成或更新技术性变更日志。使用 /launch-checklist 执行最终发布验证。使用 /day-one-patch 准备首日已知问题补丁说明。