Agent Skills
返回列表
GitHub PR 检查修复规划

GitHub PR 检查修复规划

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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,还要区分「还在跑」和「已失败」的作业,很容易在字段变更和外部检查上浪费时间。

技能如何工作

本技能围绕 定位失败检查 → 拉日志 → 归纳片段 → 出修复计划 → 经你确认后再改代码 这条链路组织。

  1. 认证与 PR 解析:在仓库内确认 gh auth status(需 repo、workflow 等 scope);优先用当前分支关联的 PR(gh pr view),也支持显式 PR 号或 URL。
  2. 检查 GitHub Actions:优先跑捆绑脚本 scripts/inspect_pr_checks.py,减轻 gh 字段漂移和 job 日志回退问题;可加 --json 给后续汇总。手工回退时用 gh pr checks / gh run view / gh api 拉 job logs。
  3. 非 Actions 检查:detailsUrl 不是 Actions run 时,只标注为外部检查并给出链接,不深入 Buildkite 等第三方。
  4. 汇总与计划:列出失败检查名、run URL、可读的日志片段;缺日志要明确说明。若有 create-plan 类技能则用之,否则内联简短计划并 等待你批准 再实施。
  5. 收尾:改完后建议重跑相关测试与 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 的维护者