Gh Pr Checks Plan Fix

概述

使用 gh 定位拉取请求（PR）中失败的检查项，获取 GitHub Actions 日志以识别可操作的失败原因，提取失败日志片段并进行摘要，随后提出修复方案，并在获得明确批准后执行修复。

• 若存在面向方案的技能（例如 create-plan），则优先调用该技能；否则需内联撰写简明方案，并在实施前请求用户批准。

前提条件：需先使用标准 GitHub CLI 完成一次身份认证（例如运行 gh auth login），再通过 gh auth status 确认认证状态（通常需具备 repo 和 workflow 权限范围）。

输入参数

• repo：仓库内的路径（默认为 .）
• pr：PR 编号或 URL（可选；默认为当前分支关联的 PR）
• 对仓库托管平台（GitHub）的 gh 认证凭据

快速开始

• python "/scripts/inspect_pr_checks.py" --repo "." --pr ""
• 如需机器可读的输出以供后续摘要处理，请添加 --json 参数。

工作流程

1. 验证 gh 认证状态。
   • 在仓库目录下运行 gh auth status。
   • 若未完成认证，则提示用户先运行 gh auth login（确保已授予 repo 和 workflow 权限），再继续后续步骤。
2. 解析目标 PR。
   • 优先采用当前分支关联的 PR：gh pr view --json number,url。
   • 若用户提供 PR 编号或 URL，则直接使用该输入。
3. 检查失败的检查项（仅限 GitHub Actions）。
   • 推荐方式：运行内置脚本（该脚本能自动适配 gh 字段变更，并支持作业日志回退机制）：
     • python "/scripts/inspect_pr_checks.py" --repo "." --pr ""
     • 添加 --json 参数以获取机器可读格式输出。
   • 手动回退方式：
     • gh pr checks --json name,state,bucket,link,startedAt,completedAt,workflow
       • 若某字段被 gh 拒绝，可依据 gh 返回的可用字段列表重新执行命令。
     • 对每个失败的检查项，从 detailsUrl 中提取 run ID，并执行以下命令：
       • gh run view --json name,workflowName,conclusion,status,url,event,headBranch,headSha
       • gh run view --log
     • 若运行日志显示任务仍在进行中，则直接获取作业日志：
       • gh api "/repos///actions/jobs//logs" > ""
4. 排除非 GitHub Actions 类型的检查项。
   • 若 detailsUrl 指向的并非 GitHub Actions 运行记录，则将其标记为外部检查项，仅报告 URL。
   • 不尝试对接 Buildkite 或其他 CI 提供商；保持工作流轻量简洁。
5. 向用户汇总失败信息。
   • 提供失败检查项名称、对应运行 URL（如有）、以及简洁的日志片段。
   • 如日志缺失，需明确指出。
6. 生成修复方案。
   • 调用 create-plan 技能，生成简明方案并请求用户批准。
7. 获得批准后执行修复。
   • 应用已批准的方案，汇总代码变更与测试结果，并询问是否需新建 PR。
8. 重新验证状态。
   • 完成修改后，建议重新运行相关测试及 gh pr checks 命令，确认问题已解决。

内置资源

scripts/inspect_pr_checks.py

用于获取 PR 中失败的检查项、拉取 GitHub Actions 日志，并提取关键失败日志片段。当仍存在未解决的失败项时，该脚本以非零退出码终止，因此可直接集成至自动化流程中。

使用示例：

• python "/scripts/inspect_pr_checks.py" --repo "." --pr "123"
• python "/scripts/inspect_pr_checks.py" --repo "." --pr "https://github.com/org/repo/pull/123" --json
• python "/scripts/inspect_pr_checks.py" --repo "." --max-lines 200 --context 40