用途:按 Keep a Changelog 格式生成与维护 CHANGELOG.md,结合 Conventional Commits 与语义化版本,从 git 历史自动整理发布说明。
主要能力:分析 git 提交并按 Added、Changed、Deprecated、Removed、Fixed、Security 分类;将 feat、fix、docs、refactor、perf、security、deprecate、remove 等提交前缀映射到对应类别;根据破坏性变更、新功能、修复建议 MAJOR/MINOR/PATCH 版本号;支持 Markdown、JSON 和简化发布说明三种输出。
使用方式:调用后先取提交,如 git log $(git describe --tags --abbrev=0 2>/dev/null || echo "")..HEAD --pretty=format:"%h %s" --no-merges;再归类并生成 Markdown。发布流程示例:git add CHANGELOG.md、git commit -m "docs: update changelog for v1.2.0"、git tag -a v1.2.0 -m "Release v1.2.0"、git push --follow-tags。可配合 gh release create v1.2.0 --title "v1.2.0" --notes-file release-notes.md。调用形式包括 /changelog、/changelog 1.2.0、/changelog --since=v1.0.0、/changelog --format=json。
适用场景:需要维护规范变更日志、生成 GitHub Release 说明或确定版本号的项目。
限制:依赖 git 历史与规范提交信息;test、ci、chore 等通常省略;具体安装方式与平台支持暂未提供。