用途:当用户要求调试或修复在 GitHub Actions 中运行的失败 PR 检查时使用。该技能通过 gh 定位失败的 PR 检查、抓取 GitHub Actions 日志、汇总可操作的失败片段,然后提出修复计划并在获得明确批准后实施。若存在面向计划的技能(如 create-plan),优先使用;否则在内联起草简短计划并在实施前请求批准。
前置条件:先用标准 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);检查失败检查项(仅限 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 等其他提供方;向用户汇总失败(检查名、运行 URL、日志片段,明确标注缺失日志);创建计划并请求批准;批准后实施并汇总 diff/测试,询问是否开 PR;最后建议重跑相关测试与 gh pr checks 确认。
限制:仅覆盖 GitHub Actions;非 Actions 检查只报告 URL;需要预先完成 gh 认证与相应权限范围;捆绑脚本在失败仍存在时以非零退出码结束,便于自动化。其他功能、收费或平台信息暂未提供。