SuperAPI AI 工具集

changelog-writer

通用与其它

查看项目

更新于 10-16 09:49

技能介绍

用途:根据版本控制历史自动生成专业的变更日志(CHANGELOG.md)和面向用户的发布说明,并对提交分类、识别破坏性变更、推荐语义化版本号。

主要能力:分析自上次发布以来的提交;解析约定式提交(feat/fix/docs 等)的 type 与 scope;读取 PR 标题与描述、issue 引用(#123)、合并提交信息与提交作者;将类型映射到 Keep a Changelog 分类(feat→Added、fix→Fixed、docs→Documentation、style/refactor→Changed、perf→Performance、test→Testing、chore/ci→Internal、BREAKING CHANGE→Breaking Changes);提取要点;按 Keep a Changelog 格式排版;给出语义化版本建议(存在破坏性变更则 MAJOR,有新功能则 MINOR,仅有修复则 PATCH);生成面向用户的发布说明草稿;为破坏性变更提供迁移指南;输出需要执行的 git tag 命令与对比视图链接。

使用方式:可配合 conventional-changelog(例:conventional-changelog -p angular -i CHANGELOG.md -s)或 git-cliff(例:git-cliff --tag v2.1.0 > CHANGELOG.md),也可用 git log 命令提取提交、贡献者与按类型的提交计数。发布流程建议先审查提交、更新 CHANGELOG.md、更新版本号、打 tag 并发布。

适用场景:库/包、应用、CLI 工具、API 服务的发布说明与变更日志。

限制:实际安装与调用细节、收费与平台信息暂未提供;资料为技能说明示例,未给出可直接执行的完整脚本保证。