SuperAPI AI 工具集

changelog-generator

通用与其它

查看项目

更新于 10-15 20:35

技能介绍

用途:在发布前或完成里程碑后,根据 Git 提交生成或更新 CHANGELOG.md,适用于 Java 项目。触发场景包括用户说“generate changelog”“update changelog”“what changed since last release”。

主要能力:检测版本号风格,优先级为 CLAUDE.md 中的 Versioning 段、Git 标签、现有 CHANGELOG.md,最后询问用户;支持 SemVer(x.y.z)、两段式(x.y)和 CalVer(YYYY.MM[.patch])。支持两种输出格式:Keep a Changelog(版本用 h2)和 pf4j 风格(版本用 h3),并沿用现有文件的标题层级、章节顺序和链接风格。将约定式提交映射到章节:feat→Added,fix→Fixed,perf/refactor→Changed,build(deps)→Changed 或 Security,BREAKING CHANGE→Changed 并加粗标注,deprecate→Deprecated。推荐使用引用式链接,并在文件底部添加版本比较链接。

使用方式:先查看现有 CHANGELOG.md 判断格式,再用 git describe --tags --abbrev=0 找最近标签,用 git log v3.14.1..HEAD --oneline 获取提交,提取 #123、fixes #123 等引用,按章节分组生成条目,并依据版本风格建议版本号(BREAKING CHANGE→主版本,feat→次版本,仅 fix→修订号)。

限制:资料未提供安装命令、收费或平台信息;无约定式提交时按 Changed 列出原始信息;无版本约定时需询问用户。