用途:根据 Git 提交历史生成或更新符合 Keep a Changelog 规范的 CHANGELOG.md,并支持语义化版本发布。触发词包括 changelog、变更日志、帮我生成 CHANGELOG、更新 CHANGELOG、发布新版本、初始化 changelog 配置。
主要能力:解析 Conventional Commits(type、scope、subject);按类型分组并加 emoji;自动识别 PR/Issue 编号并生成链接;检测破坏性变更(BREAKING CHANGE footer 或 ! 标记);按提交类型自动判定版本号(BREAKING CHANGE 升 Major、feat 升 Minor、fix 升 Patch);支持中文/英文、显示作者、排除指定类型或 scope、自定义模板与新增提交类型。
使用方式:首次在技能目录执行 cd ~/.claude/skills/changelog-generator && npm install,随后在项目目录运行 changelog-generate init 生成 .changelogrc.json。常用命令:changelog-generate generate --all 或 --from v1.0.0 --to v2.0.0;changelog-generate update [--from v2.0.0];changelog-generate release [--version 2.1.0] [--date 2023-11-10];changelog-generate preview。默认输出 ./CHANGELOG.md。可在 GitHub Actions 等 CI 中以 npm install -g changelog-generate 后运行 update 实现自动化,也可与 semantic-release、Renovate 集成。
适用场景:新项目首次生成、日常增量更新、版本发布流程、CI/CD 自动化。
限制:需要 Git 仓库(否则报 Not a git repository);提交信息不符合 Conventional Commits 时需自行归类为 Other;提交被 exclude 规则过滤或仓库无记录会导致 CHANGELOG 为空;技术栈依赖 Node.js 与 simple-git、conventional-commits-parser、semver、handlebars、commander、inquirer、chalk、ora 等。官方未提供收费、价格与具体平台兼容性信息。