用途:面向注重工程规范的开发者,把 git 提交记录整理成清晰的 changelog、判断下一个版本号、撰写面向用户的 release notes,并规范团队 commit message。
主要能力:从 git log 或 commit/PR 列表解析并分类生成结构化 changelog;依据变更内容决策 major/minor/patch 版本号;撰写比 changelog 更友好的 release notes;把杂乱变更记录整理为标准格式;提供 Conventional Commits 规范指导。分类遵循 Keep a Changelog,变更按 Breaking、Added、Changed、Deprecated、Removed、Fixed、Security 分组,每条可关联 commit hash 或 PR 编号。
用法:需用户提供变更来源(git log 输出、commit 列表、PR 列表或手动描述)、版本范围、当前版本号、项目类型(库/框架或应用)及输出格式。工具本身不直接读取 git 仓库,需用户粘贴 git log。
版本号规则:不兼容 API 变更升 MAJOR,向下兼容新功能升 MINOR,向下兼容修复升 PATCH;多种变更取最高级;0.x.y 阶段 minor 可含破坏性变更;支持 alpha/beta/rc 预发布号。
限制:不具备直接读取 git 仓库、CI/CD 自动发版配置、创建 GitHub Release、npm/PyPI 包发布、变更影响范围代码分析等能力。