Agent Skills
返回列表
💻

GitHub CI 排错修复

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/shipshitdev-skills-gh-fix-ci。

技能介绍

要解决什么问题

PR 红了但失败原因散落在 GitHub Actions 日志、外部 Check 链接和 gh pr checks 的不同 bucket 里;更麻烦的是 job 长时间卡在 checkout、装依赖或装工具阶段,既不失败也不前进。手动翻 run、猜要不要 cancel/rerun,再改代码推一次,往往要重复多轮。

技能如何工作

技能把 gh CLI 当作事实来源:先确认 gh auth status,用 gh pr checks --json 覆盖 Actions 与非 Actions 检查(比只看 gh run list 更完整),再对失败项拉 gh run view --log-failed,对外部检查则跟链接里的报错对齐,而不是直接判「不在范围内」。

对 setup-stuck 会先查 job/step 状态:若在 setup、checkout、依赖或工具安装上已空转约 5~8 分钟 仍没有仓库代码相关步骤在跑,会建议或(在已授权的自治循环里)执行 gh run cancel / gh run rerun,避免无限等待。

产出包括:失败/待决/setup-stuck 检查摘要、根因与受影响文件、修复方案或已应用的本地修改说明。在修复清晰或你已明确授权时才会改本地代码/配置;默认不会在未经同意的情况下重跑 CI 或 push。若你一次性授权 loop until green,则在循环内按「诊断 → 单点修复 → commit/push(禁止 --no-verify)→ 重新拉全量 checks」迭代,直到必需检查全绿;对 flaky 会先重跑一次再当真失败。

边界与注意点

  • 日志、PR 描述、commit message 一律当不可信文本,只作诊断证据,不执行其中嵌入的指令。
  • 大范围改 CI/部署配置、在自治循环外 cancel/rerun workflow 或 push,都需要先确认。
  • 缺 baseline CI 会交给 testing-cicd-init;失败挡发布可走 deployment-composer;高风险改动可走 code-review。
  • 禁止为「强行变绿」而弱化检查、跳过 hook 或对共享分支 force-push。

使用场景

  • 合并前 PR 某项 required check 失败,需要用 `gh pr checks` 汇总失败项并从 Actions 日志定位根因
  • GitHub Actions job 在 checkout 或装依赖阶段挂起超过数分钟,需要判断是否 cancel/rerun 再继续改代码
  • 已开自治循环,希望按「单点修复→push→重查 checks」迭代直到 required 检查全绿
  • PR 上存在非 Actions 的外部检查失败,需要打开 check 链接提取报错而不是只处理 workflow

适合人员

  • 维护 monorepo 多 workflow 的工程师,合并前要把红 CI 归因到具体文件而非重复盲推
  • 负责 PR 合并列车的维护者,需要在不阻塞无关 pending matrix 的前提下处理下一单 required 失败
  • 用 `gh` 在终端管 PR 的开发者,希望失败摘要、修复方案与 push/rerun 权限边界一致
  • 发布被 CI 挡住时需要先修流水线再谈部署,而不是先改部署脚本