用途：当用户要求诊断或修复拉取请求、分支或工作流运行中失败的 GitHub Actions 检查，或需要 CI 日志与根因分析时使用。
主要能力：优先使用 GitHub 连接器获取仓库、拉取请求、补丁、审查和检查元数据；使用 gh 发现当前分支的 PR 以及 GitHub Actions 的运行、作业、制品和日志。可记录失败检查的名称、运行 URL、作业、失败步骤、head SHA 和结论，并区分回归、不稳定基础设施、外部服务故障、缺失凭据或无关的基线失败。
使用方式：从请求和本地 Git 上下文解析仓库与失败目标，目标不明确时才询问。用 gh pr checks 发现失败检查及其运行或作业标识，再用 gh run view <run-id> --log-failed、gh run view <run-id> --job <job-id> --log 或通过 gh api 的 job-logs 端点拉取最小有用日志片段。仅在相关时阅读 references/ci-failure-playbook.md。应用最小授权修复，运行最接近的本地等效检查；仅在请求授权外部变更时才推送、重跑或触发工作流。最后重新检查确切的失败检查并报告残余失败、不可用日志和未验证假设。
限制：不得声称连接器能获取 Actions 日志（当该能力不可用时）；不得暴露日志中的机密；非 GitHub Actions 检查视为外部，报告其状态和 URL，除非用户要求单独调查。工作流触发器、令牌权限、机密、pull_request_target 和 fork 代码执行属于安全敏感项，不得仅为让作业通过而扩大访问权限。未完成成功运行前不得报告 CI 为绿色。交付物应包含失败运行与步骤、根因、聚焦差异、本地检查、结果运行状态和剩余风险。