Files
2026-07-13 21:36:49 +08:00

2.6 KiB
Raw Permalink Blame History

name, description
name description
release-notes 根据工单、产品需求文档或更新日志生成面向用户的发布说明。创建按类别(新功能、改进、修复)组织的清晰、吸引人的摘要。在编写发布说明、创建更新日志、宣布产品更新或总结已发布内容时使用。

发布说明生成器

将技术工单、产品需求文档或内部更新日志转化为经过润色的、面向用户的发布说明。

上下文

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

如果用户提供了文件(JIRA 导出、Linear 工单、产品需求文档、Git 日志或内部更新日志),请先阅读它们。如果用户提到了产品 URL,请使用网页搜索来了解产品和受众。

操作说明

  1. 收集原始素材:阅读所有提供的工单、更新日志或描述。提取以下信息:

    • 什么发生了变化(功能、改进还是修复)
    • 影响谁(哪个用户群体)
    • 为什么重要(用户收益)
  2. 对变更进行分类

    • 新功能:全新的能力
    • 改进:对现有功能的增强
    • Bug 修复:已解决的问题
    • 破坏性变更:需要用户采取行动的任何内容(迁移、API 变更)
    • 弃用:正在逐步淘汰的功能
  3. 按照以下原则编写每条条目

    • 以用户收益开头,而非技术变更
    • 使用通俗易懂的语言——避免行话、内部代号或工单编号
    • 每条条目控制在 1-3 句话
    • 如果用户提供了视觉素材或截图,请一并包含

    转换示例

    • 技术性:"为仪表盘 API 端点实现了 Redis 缓存层"

    • 面向用户:"仪表盘加载速度提升最高 3 倍,让你减少等待时间,把更多时间花在分析上。"

    • 技术性:"修复了并发结账流程中的竞态条件"

    • 面向用户:"修复了在高流量时段某些订单可能失败的问题。"

  4. 组织发布说明的结构

    # [产品名称] — [版本 / 日期]
    
    ## 新功能
    - **[功能名称]**:[1-2 句描述,说明它的功能及重要性]
    
    ## 改进
    - **[领域]**:[哪些方面得到了改善及其帮助]
    
    ## Bug 修复
    - 修复了[用用户能理解的术语描述的问题]
    
    ## 破坏性变更(如有)
    - **需要采取行动**:[用户需要做什么]
    
  5. 调整语气,使其与产品的调性相匹配——B2B 产品使用专业语气,面向消费者的产品使用友好语气,API 产品使用开发者导向的语气。

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