GitHub PR 检查修复助手
定位 GitHub Actions PR 检查失败并制定获批后修复方案。
证据显示该技能主要执行只读的 gh 查询和日志获取,并要求认证失败时由用户先登录,实施修改前明确请求批准;但要求 repo 与 workflow 权限,未说明日志中可能包含的机密数据、数据流、最小权限边界或回滚方案,因此扣分。
脚本包含认证检查、PR 解析、字段兼容回退、运行日志与作业日志回退及错误状态;但未提供测试,GitHub API 返回 ZIP 日志时直接标记为无法解析,且失败标记提取较粗糙。静态评估无法超过 10 分,因此扣分。
目标用户、输入参数、GitHub Actions 范围和外部检查的非适用边界较清楚;但默认当前分支 PR 的假设、对 GitHub CLI/GitHub 网络的依赖,以及未说明中文输出或中国大陆网络可达性,限制了适用性。
SKILL.md 具有概览、前置条件、输入、快速开始、工作流和资源说明,命名与入口基本稳定;但缺少技能版本、变更记录、维护责任与更新路径,许可证信息在所给材料中不可确认,且仓库 README 标明已废弃,因此扣分。
脚本能够获取失败检查、运行元数据和日志片段,并输出文本或 JSON,能完成核心诊断任务;但实现修复仍依赖后续人工代理流程,日志解析可能不完整,且没有静态可验证的代表性输出或比较优势证据,因此扣分。
脚本源码、参数和错误分支可审计,但没有提交的测试套件、CI 覆盖或第三方执行证据,结论主要来自有限的静态材料,因此仅给低分。
- 执行前确认 GitHub CLI 的认证范围,并避免将包含令牌、密钥或个人信息的日志直接写入文件或输出。
- GitHub API 作业日志可能以 ZIP 返回,当前脚本会将其视为无法解析;应人工核验日志是否确实不可用。
- 该仓库已标记为废弃,安装或采用前应确认技能仍有维护来源和兼容性。
- GitHub 服务和 CLI 可能受中国大陆网络可达性影响。
它能做什么 & 适用场景
该技能用于调试或修复 GitHub Actions 执行的 GitHub PR 检查失败。它通过 GitHub CLI 查看检查状态、运行详情和日志,提取可操作的失败片段,并总结失败上下文。技能会先提出修复计划,只有获得明确批准后才实施修改。Buildkite 等外部检查提供商不在范围内。
验证 gh 认证状态;解析当前分支或指定 PR;读取 GitHub Actions 检查、运行详情和日志;在运行仍进行时通过 GitHub API 获取作业日志;提取并总结失败片段;对外部检查仅标记为外部并报告详情 URL;获批后实施修复,并建议重新运行测试和 gh pr checks。
- 开发者需要调查当前分支 PR 的 GitHub Actions 失败时,使用默认 PR 解析流程。
- 维护者提供 PR 编号或 URL,需要检查指定 PR 的失败检查时使用。
- CI 日志较长,需要自动提取简洁失败片段供总结时使用。
- 检查仍在运行但常规日志不可用,需要通过作业日志接口获取信息时使用。
优缺点一览
- 覆盖 PR 定位、检查读取、日志提取、失败摘要和获批后实施的完整流程。
- 提供 inspect_pr_checks.py 脚本,并支持 JSON 输出。
- 明确限制在 GitHub Actions,避免处理外部 CI 提供商。
- 依赖已认证的 GitHub CLI,以及 repo 和 workflow 权限。
- 只处理 GitHub Actions;Buildkite 等外部检查仅报告详情 URL。
- 源材料未提供测试套件、跨平台验证或具体修复策略。
- 该仓库已弃用,README 建议改用 OpenAI Plugins repository 中的当前示例。
如何安装
在 Codex 中安装 curated 技能:$skill-installer gh-fix-ci。安装后重启 Codex 以加载技能。README 未说明该技能目录的独立许可证;许可证应在其目录中的 LICENSE.txt 查找。
如何使用
先确保已运行 gh auth login,并具备通常所需的 repo 与 workflow 权限。可用示例命令:python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "123";需要机器可读输出时追加 --json。也可直接要求:“检查这个 PR 的 GitHub Actions 失败原因,先总结日志并提出修复计划,未经我批准不要修改。”
对比同类
该仓库已弃用;README 建议使用 OpenAI Plugins repository 获取当前 Codex 技能和插件示例。