用途:专门处理 GitHub 拉取请求中失败的 GitHub Actions 检查,不旁及其他 CI 提供商。工作流程为混合式:用本插件内的 GitHub 应用获取 PR 元数据、变更文件与评审上下文;用 gh 查看 Actions 检查与日志,因为连接器未完整暴露该工作流。
主要能力:解析 PR(用户提供编号或 URL,否则取当前分支 PR);获取失败检查清单;提取失败运行的日志片段;区分非 GitHub Actions 检查并仅报告其 URL;汇总失败与根因;给出聚焦修复方案并在批准后实施。
使用方式:前提是用 GitHub CLI 完成一次认证,并用 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 ... 与 gh run view <run_id> --log;若日志显示仍在进行中,则用 gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" 拉取作业日志。脚本在失败仍存在时以非零状态退出,可用于自动化。
适用场景:需按 PR 定位并修复 Actions 失败、希望先看根因再决定是否改代码的场景;日志缺失会明确说明,不夸大确定性。
限制:不处理 Buildkite 等外部提供商,非 Actions 检查仅报告 URL;若失败与本地 diff 明显无关,应先说明再提议改代码;实施修改需用户明确批准;仓库与认证相关具体细节(收费、价格等)资料暂未提供。