SuperAPI AI 工具集

ci-triage

通用与其它

查看项目

更新于 10-16 02:33

技能介绍

用途:ci-triage 用于冷启动排查 CI 红色状态,回答“是否有东西失败”和“为什么失败”,起点是分支名或提交,而不是别人给的 URL。

主要能力:核心规则是不要用 run 级 conclusion 判断是否绿色,而应查询该提交的 check-runs。因为 GitHub Actions 的 run 汇总是有损的:某个 job 失败但 run 同时被取消时,run 汇总为 cancelled,gh run list 会过滤掉,而 UI 仍把该提交标红。

必要用法:用 gh api repos/nubjs/nub/commits/$SHA/check-runs --paginate 配合 --jq 过滤非 success、skipped、neutral 的 check,空输出才是真正绿色。注意 --paginate 会每页执行一次 --jq,聚合统计会每页各返回一个结果;需要跨页统计时应使用 --slurp 并管道给外部 jq,且 --slurp 不能与 --jq 同用。诊断单个失败时按 run、job、log 顺序:gh run view <run-id> --json ...、gh run view <run-id> --json jobs、gh run view <run-id> --log-failed,并用 sed 去除 ANSI 转义。

适用场景:判断提交是否真红、排查被 cancel-in-progress 取代的运行、检查 gate job 聚合矩阵腿时把 cancelled 误判为失败的反模式。

限制与注意:不要用 conclusion=="failure" 过滤 gh run list 并据无结果判定绿色;不要只取每个 workflow 最新一次运行;不要只信 --branch main;不要因机器人 issue 缺失就断定不失败;不要通过管道读取退出码。报告发现时应给出提交、check 名称、run URL、同 SHA 后续运行是否通过以及机制。