用途:当用户要求生成 changelog、更新日志、版本记录或 release notes 时激活,从 Git 历史自动整理出结构化 CHANGELOG。
主要能力:按 Conventional Commits 分类提交,包括 feat(新功能)、fix(Bug 修复)、docs(文档)、refactor(重构)、perf(性能优化)、test(测试)、chore(构建/工具)、Breaking Changes、安全修复、依赖更新,并配对应图标。依据 Semantic Versioning 确定版本号:含 BREAKING CHANGE 或 type 后加 ! 时主版本 +1;存在 feat 时次版本 +1;仅 fix/docs/chore 等时修订版本 +1;安全修复按修订版本紧急发布。
使用方式:先获取最近 tag 与提交范围,例如 git describe --tags --abbrev=0、git log --oneline <last-tag>..HEAD,或指定范围 git log --oneline v1.0.0..HEAD;无 tag 时用 git log --oneline 选择起始提交或查看全部历史。随后分类提交并生成 CHANGELOG,输出含版本号、日期与分类条目。
注意事项:Breaking Changes 必须置于最前并加粗突出;每条记录关联 Issue/PR 编号;安全修复注明 CVE 编号(如有);版本号应与 git tag 一致;预发布版本使用 -beta.1、-rc.1 后缀;可维护 CHANGELOG.md,每次 release 追加到顶部。
限制:资料未提供安装命令、平台支持范围、收费方式及具体实现细节,暂未提供。