SuperAPI AI 工具集

changelog

通用与其它

查看项目

更新于 10-15 21:38

技能介绍

用途:为新版本生成或更新 CHANGELOG.md,通过分析上次发布标签以来的已合并 PR 整理发布说明。用户需提供版本号(如 0.5.3),可选提供尚未合并但需纳入的 PR。

主要能力:先收集数据,包括查找上一个发布标签、列出该标签以来的合并提交、获取 PR 详情与贡献者列表;再识别外部贡献者,通过检查 git 历史中是否存在 @entire.io 邮箱判断内外部,并参考 memory/project_team_members.md 中的已知映射;最后按现有 CHANGELOG.md 风格写入新版本条目。

使用方式:常用命令包括 git tag --sort=-version:refname | head -1、git log <tag>..HEAD --merges --format='%s' | grep -v "Merge branch"、gh pr list --state merged --base main --search "merged:><tag-date>" --json number,title,author --limit 50、git log <tag>..HEAD --format='%an' --no-merges | sort | uniq -c | sort -rn,以及 git log --all --format='%an <%ae>' --author="<name>" | sort -u。

格式与规则:新版本段落插入 CHANGELOG.md 顶部、头部之后、上一版本之前,格式为 ## [X.Y.Z] - YYYY-MM-DD,包含 Added、Changed、Fixed、Housekeeping、Thanks 等小节,空小节省略;每条以短横线开头,末尾附完整 PR 链接 #N,不加句号;相关 PR 可合并为一条;进行中的功能需明确标注;已知限制需内联说明;Thanks 仅列外部贡献者并说明具体贡献;依赖升级通常合并为一条 Housekeeping。日期使用当前日期 YYYY-MM-DD。

适用场景:发布新版本时自动生成结构化变更日志,减少手工整理 PR 的工作量。

限制:依赖 git 与 gh 命令及仓库历史;外部贡献者判断依赖邮箱与团队映射文件;具体效果与平台支持暂未提供。