SuperAPI AI 工具集

gh-fix-ci

部署与运维

查看项目

更新于 10-16 03:43

技能介绍

用途:当用户请求调试或修复在 GitHub Actions 中运行的失败 PR 检查时使用。核心流程是先定位失败的检查,抓取可行动的日志,总结失败片段,再提出修复计划并在获得明确批准后实施。

前提与准备:需先用标准 GitHub CLI 完成一次性认证,例如运行 gh auth login,然后通过 gh auth status 确认,通常需要 repo 与 workflow 权限范围。输入包括 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,用户提供编号或 URL 则直接使用);检查失败项(优先运行捆绑脚本,手动回退可用 gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow,若字段被拒则改用 gh 报告的可用字段,再从 detailsUrl 取 run id,运行 gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha 与 gh run view <run_id> --log,若日志显示仍在进行可改用 gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs");对非 GitHub Actions 检查标注为外部并只报告 URL,不处理 Buildkite 等其他提供方;向用户总结失败名称、运行 URL 与简要日志片段,并明确指出日志缺失情况;创建计划(若有 create-plan 类技能则使用,否则内联起草简要计划并请求批准);批准后实施,总结差异与测试并询问是否开 PR;变更后建议重跑相关测试与 gh pr checks 确认。

限制:仅针对 GitHub Actions;其他 CI 提供方不处理;实施前必须获得明确批准。