SuperAPI AI 工具集

release-health

通用与其它

查看项目

更新于 10-15 23:48

技能介绍

用途:评估仓库的发布就绪度,回答“现在该不该发版”。适用于公开且带正式发布的仓库(Tier 4 完整评估);Tier 3 仅作信息展示并说明发布流程非正式;Tier 1-2 完全跳过。在完整评估中作为第 2 个模块运行(在 Security 之后),并负责 CHANGELOG 漂移评估。

主要能力:检查是否存在发布;统计自上次发布以来的未发布提交数(0 条为最新,1-5 条可能不足以发版,6 条以上可能该发版);对比 CHANGELOG 中最新版本与最新发布标签,判断一致、超前或滞后;查找草稿发布;计算距上次发布天数、最近 5 次发布的平均间隔,以及当前间隔是否超过平均值的 2.0 倍(可配置)。

使用方式:通过 gh-manager 命令操作,例如 gh-manager releases latest --repo owner/name、releases compare、releases changelog、releases list --limit 10。创建草稿需所有者批准:gh-manager releases draft --repo owner/name --tag v1.3.0 --name "v1.3.0" --body "Release notes...";发布草稿:gh-manager releases publish --repo owner/name --release-id 12345。更新 CHANGELOG 可通过创建分支与 PR 完成。

限制:发布不可逆,发布后立即公开、触发通知与 webhook,只能删除发布且标签仍可见,因此发布前需用 AskUserQuestion 确认。完整评估模式下不输出单独的 Release Health 横幅,而是汇入统一视图。可配置项包括 enabled、changelog_files(默认 CHANGELOG.md、CHANGES.md、HISTORY.md)、cadence_warning_multiplier(默认 2.0)。错误处理会提示无发布、无未发布提交或无 changelog 文件。具体收费、价格与平台支持暂未提供。