SuperAPI AI 工具集

gh-fix-ci

测试与质量

查看项目

更新于 10-16 05:47

技能介绍

用途:当用户要求调试或修复在 GitHub Actions 中运行的失败 PR 检查时使用。通过 gh 定位失败的 PR 检查、获取 GitHub Actions 日志、总结可操作的失败片段,然后提出修复计划,并在获得明确批准后实施。

主要能力:验证 gh 认证状态;解析 PR(默认当前分支 PR,也可指定编号或 URL);检查失败的检查项(仅限 GitHub Actions);提取失败日志片段;对非 GitHub Actions 的检查仅标注为外部并报告 URL;汇总失败信息;拟定计划并请求批准;实施后总结差异与测试并询问是否开 PR;建议重新运行相关测试与 gh pr checks 确认。

使用方式:先完成一次标准 GitHub CLI 认证,例如运行 gh auth login,再用 gh auth status 确认(通常需要 repo 与 workflow 权限范围)。快速开始: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 name,workflowName,conclusion,status,url,event,headBranch,headSha 与 gh run view <run_id> --log;若日志显示仍在进行中,可直接获取作业日志:gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>"。若存在面向计划的技能(如 create-plan)则使用它,否则内联起草简明计划并请求批准后再实施。

适用场景:需要快速定位并修复 GitHub Actions 中 PR 检查失败的开发与协作流程。

限制:仅处理 GitHub Actions 检查,不尝试 Buildkite 等其他提供方;非 GitHub Actions 检查只报告 URL;需要预先完成 gh 认证;日志缺失时会明确说明;实施前必须获得明确批准。其他细节暂未提供。