SuperAPI AI 工具集

releasenotes

通用与其它

查看项目

更新于 10-16 09:55

技能介绍

用途:在 Git 仓库中比较两个版本,生成面向普通用户而非开发者的发布说明。调用格式为 $releasenotes <fromVersion> <toVersion>,只返回代码围栏内的最终 markdown,不附加其他评论。

主要能力:仅使用 shell 与 git 收集数据。按规则将提交分为 BIG FEATURES、Features、Bug Fixes、Infrastructure(可选)。含 feat!、BREAKING CHANGE、major:、#big 的提交归为 BIG FEATURES;feat: 或 feat(scope): 以及明显新增用户可见功能的无前缀提交归为 Features;fix:、fix(scope): 或含 bug/hotfix 的提交归为 Bug Fixes;影响可靠性的运维、部署、安全、性能改进可归为 Infrastructure,为空则省略该节。

使用方式:先检测仓库远程地址,将 git@github.com:owner/repo.git 归一化为 https://github.com/owner/repo,HTTPS 地址则去掉 .git。然后用 git log --no-merges --pretty=format:%H%x00%s%x00%b%x00COMMIT_END%x00 <fromVersion>..<toVersion> 获取提交并解析为 {hash, subject, body}。之后移除被回滚的提交及其回滚提交,将 fixup! 合并到父提交,分类并合并同一功能领域的相关提交,最后以用户视角重写条目。

输出结构:代码围栏内的 markdown,可含 HEADER IMAGE、各 BIG FEATURE 的 H2 标题与 1-3 行描述、✨ Features、🐛 Bug Fixes、Infrastructure、以及 Full Changelog 链接。远程地址已知时链接为 <repoUrl>/compare/<fromVersion>...<toVersion>,否则保留纯文本行。

限制:排除纯 CI、lockfile、chore、docs、refactor、test 等无用户影响的提交;排除 fixup! 与相互抵消的回滚提交;不输出文件路径、提交信息简写或 scope 标签。关于收费、价格、平台与具体效果,资料暂未提供。