# Release Notes

> 根据工单、PRD（产品需求文档）或变更日志生成面向用户的发布说明，按类别（新功能、改进、修复）整理清晰、有吸引力的摘要。适用于编写发布说明、创建变更日志、发布产品更新公告，或总结本次发布内容。

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

---


## 发布说明生成器

将技术工单、PRD（产品需求文档）或内部变更日志转化为精致的面向用户发布说明。

### Context（背景）

你正在为 **$ARGUMENTS** 编写发布说明。

如果用户提供了文件（JIRA 导出、Linear 工单、PRD、Git 日志或内部变更日志），请先阅读。如果他们提到产品 URL，可使用网络搜索了解产品和受众。

### Instructions（操作指南）

1. **收集原始素材**：阅读所有提供的工单、变更日志或描述，提取：
   - 变更了什么（功能、改进或修复）
   - 影响了哪些用户（哪个用户群体）
   - 为什么重要（用户收益）

2. **对变更进行分类**：
   - **新功能**：全新的能力
   - **改进**：对现有功能的增强
   - **缺陷修复**：已解决的问题
   - **破坏性变更**：任何需要用户采取行动的内容（迁移、API 变更）
   - **废弃说明**：即将下线的功能

3. **遵循以下原则撰写每个条目**：
   - 以用户收益为先，而非技术变更
   - 使用通俗语言——避免行话、内部代号或工单编号
   - 每个条目控制在 1-3 句话
   - 如果用户提供了视觉稿或截图，附上

   **转化示例**：
   - 技术描述："为仪表板 API 端点实现 Redis 缓存层"
   - 用户版本："仪表板加载速度提升最高 3 倍，让你花更少时间等待，更多时间分析数据。"

   - 技术描述："修复并发结账流程中的竞态条件"
   - 用户版本："修复了在高流量期间部分订单可能失败的问题。"

4. **结构化发布说明**：

   ```
   # [产品名称] — [版本 / 日期]

   ## 新功能
   - **[功能名称]**：[1-2 句话描述功能内容及重要性]

   ## 改进
   - **[改进方向]**：[什么变得更好了，以及如何帮助用户]

   ## 缺陷修复
   - 修复了 [用户语言描述的问题]

   ## 破坏性变更（如有）
   - **需要操作**：[用户需要做什么]
   ```

5. **调整语气**以匹配产品的声音——B2B 产品专业严谨，消费者产品亲切友好，API 产品以开发者为中心。

保存为 Markdown 文档。如果用户需要 HTML 或其他格式，相应转换。