SuperAPI AI 工具集

gh-fix-ci

通用与其它

查看项目

更新于 10-16 03:13

技能介绍

用途:用 gh 定位失败的 PR 检查,获取 GitHub Actions 日志,总结失败片段,提出修复计划并在用户明确批准后实施。依赖 plan 技能来起草和批准修复计划。

前提:确保 gh 已认证(例如先运行 gh auth login),再以提升权限运行 gh auth status(包含 workflow/repo 作用域)使 gh 命令可用。若沙箱阻止 gh auth status,用 sandbox_permissions=require_escalated 重跑。

输入:repo(仓库内路径,默认 .)、pr(PR 编号或 URL,可选,默认当前分支 PR)、仓库主机的 gh 认证。

快速开始:python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>";加 --json 获得机器可读输出。

工作流:验证 gh 认证;解析 PR(优先当前分支 gh pr view --json number,url);检查失败检查(仅 GitHub Actions),优先用脚本,手动回退用 gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow,对每个失败检查从 detailsUrl 提取 run id 并运行 gh run view <run_id> --json ... 与 gh run view <run_id> --log,若日志显示仍在进行则用 gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" 获取;非 GitHub Actions 检查标记为外部并只报告 URL,不处理 Buildkite 等;向用户总结失败(检查名、run URL、日志片段,缺失日志需说明);用 plan 技能起草计划并请求批准;批准后实施并总结 diff/测试,询问是否开 PR;之后建议重跑相关测试与 gh pr checks 确认。

限制:仅支持 GitHub Actions 检查;需要 gh 认证与相应权限;沙箱可能需提升权限;其他 CI 提供商不处理。