SuperAPI AI 工具集

make-changelog

通用与其它

查看项目

更新于 10-15 22:11

技能介绍

用途:根据 git 提交历史创建或更新 CHANGELOG.md,采用 Keep-a-Changelog 格式,并按版本区间并行处理。

主要能力:通过脚本 list_ranges.py 校验仓库并列出所有版本区间;支持三种模式——fresh(无 CHANGELOG.md 时全量生成)、fill(已有文件时仅补全未覆盖区间)、unreleased-only(仅刷新 Unreleased 段)。每个非空区间启动一个 haiku 子代理,最多 12 个,按用户可观察影响分类(Added、Changed、Deprecated、Removed、Fixed、Security),跳过合并提交、CI 配置、版本号提交和纯格式改动,使用现在时祈使句。

使用方式:先运行 python3 ${CLAUDE_PLUGIN_ROOT}/skills/make-changelog/scripts/list_ranges.py --output json 获取区间;已有 CHANGELOG.md 时用 --since-tag <last_documented_tag> 获取未覆盖区间。随后并行启动子代理,收集结果后按新版本在前组装,fresh 模式写入文件,fill 模式用 Edit 插入到 # Changelog 头部之后、首个 ## 条目之前。

适用场景:需要从 git 历史自动维护变更日志的项目。

限制:脚本退出码 2 表示非 git 仓库或无提交,需停止并报告错误;区间超过 12 个需询问用户;意图不明确时需让用户选择模式;无法确定分类的提交需标记供人工复核。其余细节资料未提供。