SuperAPI AI 工具集

changelog-generator

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

用途:从 git 提交历史自动生成 CHANGELOG.md,遵循 Keep a Changelog 格式,并按类型分组变更、关联提交与 PR,同时维护语义化版本。

主要能力:解析 git 提交历史;按类型分组(Added、Changed、Fixed、Deprecated、Removed、Security 等);支持 Conventional Commits 前缀自动归类(如 feat→Added、fix→Fixed、docs→Documentation、refactor/perf/style→Changed、test→Testing、build→Build、ci→CI/CD、chore→Maintenance、revert→Reverted);链接 issue、PR 与 commit;检测破坏性变更并生成迁移指南;根据变更推断语义化版本(Major 破坏性变更、Minor 新功能、Patch 仅修复);可更新已有 CHANGELOG.md,保留原有条目。

使用方式:先分析 git 历史,例如 git log v1.0.0..HEAD --pretty=format:"%H|%s|%an|%ad" --date=short,无发布版本时用 git log --pretty=format:"%H|%s|%an|%ad" --date=short;再解析提交信息并归类;最后生成或更新 CHANGELOG.md。支持从零生成、增量更新、为指定版本发布(将 [Unreleased] 移入版本号并添加日期、更新比较链接)。

适用场景:需要维护规范变更日志的软件项目,尤其是采用 Conventional Commits 与语义化版本的仓库。

限制:依赖 git 提交历史与提交信息质量;工具要求 Bash、Write、Read 能力;具体安装方式、收费与平台支持暂未提供。