GitHub PR 检查修复规划
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_0f11e42a/ceshi2。
技能介绍
问题场景
PR 合并前常被 GitHub Actions 或其它 CI 挡住:gh pr checks 只告诉你「红了」,真正有用的信息散落在 workflow run 的日志里。手动从 detailsUrl 抠 run id、再 gh run view --log,还要区分「还在跑」和「已失败」的作业,很容易在字段变更和外部检查上浪费时间。
技能如何工作
本技能围绕 定位失败检查 → 拉日志 → 归纳片段 → 出修复计划 → 经你确认后再改代码 这条链路组织。
- 认证与 PR 解析:在仓库内确认
gh auth status(需repo、workflow等 scope);优先用当前分支关联的 PR(gh pr view),也支持显式 PR 号或 URL。 - 检查 GitHub Actions:优先跑捆绑脚本
scripts/inspect_pr_checks.py,减轻gh字段漂移和 job 日志回退问题;可加--json给后续汇总。手工回退时用gh pr checks/gh run view/gh api拉 job logs。 - 非 Actions 检查:
detailsUrl不是 Actions run 时,只标注为外部检查并给出链接,不深入 Buildkite 等第三方。 - 汇总与计划:列出失败检查名、run URL、可读的日志片段;缺日志要明确说明。若有
create-plan类技能则用之,否则内联简短计划并 等待你批准 再实施。 - 收尾:改完后建议重跑相关测试与
gh pr checks验证。
边界与注意
- 依赖已登录的 GitHub CLI,且对目标仓库有读 workflow/日志的权限。
- 自动化脚本在仍有失败检查时会 非零退出,适合挂在脚本流水线里做门禁。
- 不负责修复外部 CI 提供商内部的失败,只帮你把 GitHub Actions 侧的信息对齐到可执行的修复步骤。
使用场景
- 合并前 `gh pr checks` 全红,需要从 Actions run 日志里抽出失败片段再决定改哪段代码
- 当前分支已开 PR,push 后 workflow 失败,想先看清是测试、lint 还是构建步骤挂掉
- Review 他人 PR 时检查项失败,要把 run URL 和关键日志整理给作者或自己跟进修复
- 在本地或脚本里跑 `inspect_pr_checks.py`,用非零退出判断 PR 是否仍有未解决的 GitHub Actions 失败
适合人员
- 负责主干合并、经常要对着失败 workflow 查日志的后端或平台工程师
- 贡献者 PR 被 Actions 拦住,不熟悉 `gh run view` 与 job 日志回退路径的开发者
- 维护 monorepo 多 workflow 的 Tech Lead,需要统一流程:汇总失败 → 写计划 → 批准后再改
- 在合并前用 GitHub CLI 自检 PR 状态、希望 agent 只在外部检查上给链接、不深挖 Buildkite 的维护者