SuperAPI AI 工具集

release-notes

通用与其它

查看项目

更新于 10-15 21:35

技能介绍

用途:从两个 Git 引用之间的提交历史生成专业发布说明,自动分类为面向用户与内部两类内容。

主要能力:解析提交(parse-commits.cjs)提取 hash、类型、scope、描述、破坏性标记、作者、日期与变更文件;分类(categorize-commits.cjs)按 feat/fix/perf/docs/refactor 等映射到功能、修复、改进、文档或内部;渲染(render-template.cjs)生成含 Summary、What's New、Improvements、Bug Fixes、Breaking Changes、Technical Details 的 Markdown。进阶能力包括服务边界检测(detect-services.cjs)、破坏性变更分析(detect-breaking.cjs)、PR 元数据提取(extract-pr-metadata.cjs,可加 --fetch-gh 调用 gh CLI)、贡献者统计(contributor-stats.cjs)、语义化版本递增(bump-version.cjs,支持 --prerelease、--service、--dry-run)与质量校验(validate-notes.cjs,默认阈值 70,可 --json)。

使用方式:以 $release-notes [base] [head] [--version vX.Y.Z] [--output path] 调用,或按 parse → categorize → render → validate → transform 管道串联执行,例如 node .claude/skills/release-notes/lib/parse-commits.cjs v1.0.0 HEAD | node .claude/skills/release-notes/lib/categorize-commits.cjs | node .claude/skills/release-notes/lib/render-template.cjs --version v1.1.0 --output docs/release-notes/250111-v1.1.0.md。LLM 转换需设置 ANTHROPIC_API_KEY,支持 summarize、business、enduser、executive、technical 类型。

适用场景:版本发布、分支对比、变更日志生成、CI 质量门禁。

限制:生成的说明默认为 Draft 状态,需人工审核、补充与批准后才能发布;非规范提交会归入 other;配置项见 config.yaml;具体平台与收费信息暂未提供。