GitHub CI 排错修复
将以下提示词粘贴到你的 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 挡住时需要先修流水线再谈部署,而不是先改部署脚本