用途:把原始提交日志、PR 标题或变更清单转化为面向用户的发布说明或 changelog 条目。原始提交是写给作者的,changelog 是写给用户的,该技能负责完成这一转换。
主要能力:按类型分组输出(Added、Changed、Deprecated、Fixed、Security),省略空章节;将破坏性变更置于最前,并为每条给出具体迁移步骤;每行以用户可见的结果表述,而非原始提交信息;在可用时附上 issue/PR 引用;必要时补充升级说明;若版本号由推断得出,用一行说明语义化版本依据(破坏性→主版本,功能→次版本,修复→补丁版本)。
必要输入:变更内容(提交信息、PR 标题或变更要点列表);版本号与日期(或按 semver 协助选择);受众(终端用户、API 使用者、库开发者,决定语气);可选约定(Keep a Changelog、既有风格、issue/PR 链接)。这些信息若未提供需主动询问。
输出格式:遵循 Keep a Changelog 约定,首行为 [version] — [date],随后依次为破坏性变更(如有)、Added、Changed、Deprecated、Fixed、Security,最后按需给出升级说明与语义化版本说明。
质量检查:条目按类型分组且省略空章节;破坏性变更置顶并附具体迁移步骤;行文为用户可见结果而非原始提交;在可用处包含引用;版本号符合语义化版本规则。
反模式:不要粘贴原始提交信息;不要把破坏性变更埋在功能列表中;不要包含用户不关心的内部噪音(重构、CI 调整);不要把不同变更类型混在一张列表;不要错误判断版本号(破坏性变更是主版本而非补丁)。
限制:该技能基于 Keep a Changelog 标准与语义化版本规范,具体平台支持、收费与价格信息暂未提供。