Release Notes

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

killvxk b09f492 2.5 KB Updated

File contents

发布说明生成器

将技术工单、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 或其他格式,相应转换。

killvxk/pm-skills-zh/tree/main/pm-execution/skills/release-notes commit b09f49240b

Frequently asked questions

npx skillmds@latest add killvxk/release-notes