SuperAPI AI 工具集

gh-fix-ci

通用与其它

查看项目

更新于 10-16 06:17

技能介绍

用途:用 gh 定位失败的 PR 检查,拉取 GitHub Actions 日志,把关键失败片段总结给用户,再借助 plan 技能起草修复计划,经明确批准后实施,最后建议重跑测试与 gh pr checks 确认。

主要能力:解析当前分支或指定 PR;仅针对 GitHub Actions 检查,非 Actions 的 detailsUrl 标记为外部并只报告 URL,不处理 Buildkite 等其他提供方;提供捆绑脚本 scripts/inspect_pr_checks.py,可处理 gh 字段变动与作业日志回退,失败时非零退出,便于自动化。

使用方式:前置需 gh 已认证,如 gh auth login,然后运行 gh auth status(含 workflow/repo 权限);沙箱阻止时用 sandbox_permissions=require_escalated 重试。快速开始:python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>",加 --json 获得机器可读输出。手动回退:gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow;对每个失败项从 detailsUrl 取 run id,运行 gh run view <run_id> --json 及 --log;日志显示仍在进行时用 gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" 拉取作业日志。

适用场景:本地或自动化流程中快速诊断 PR 上的 CI 失败并给出修复方案。

限制:依赖 gh 认证与仓库访问;不支持非 GitHub Actions 的检查提供方;脚本参数 --repo/--pr/--max-lines/--context/--json 用法见资料,其余收费、平台等信息暂未提供。