用途:从 git 历史生成可读的变更日志(CHANGELOG)和发行说明,让用户和相关方了解版本变化。适用于用户索要“changelog/发行说明/某版本改了什么”、准备发布(打标签或发布前)、维护 CHANGELOG.md,以及发布周期结束后记录已交付工作。
主要能力与用法:先确定提交范围,即两个引用(如 v1.1.0..HEAD、main..release/1.2)或明确提交列表,含糊时向用户确认。随后用 git log --oneline BASE..HEAD 获取提交,可按路径或作者过滤。若使用约定式提交,则按类型分组:feat→Added、fix→Fixed,docs→Changed 或内部省略,perf→Changed 或 Added,refactor→Changed(用户可见时)或省略,chore/ci/build→一般省略,BREAKING CHANGE→Breaking 或 Changed 并说明迁移。合并去重相近条目,每条变更一行,可按项目习惯附 issue/工单号;不得凭想象编造,提交信息含糊时尽量从 diff 推断或使用中性描述并注明需核实。套用项目既有 CHANGELOG 风格(如 Keep a Changelog),省略空章节,加版本标题与日期,格式为 ## [X.Y.Z] - YYYY-MM-DD,章节含 Added、Changed、Deprecated、Removed、Fixed、Security。发行说明基于同一批数据输出:1–2 句摘要、面向用户/开发者的影响要点、破坏性变更与迁移步骤、完整变更日志链接。
限制与规则:只包含给定提交或 diff 中的变更;匹配项目风格(含章节名称与顺序,如 newest first 或 oldest first);一处逻辑变更合并为一条;优先追加而非新建重复文件;未核查前不要声称“无破坏性变更”。具体命令与示例中的 URL、代码保持原样。官方文本未提供更多安装方式、平台或收费信息。