Agent Skills
返回列表
GitHub CLI 操作助手

GitHub CLI 操作助手

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_5c68097a/github-qinghong。

技能介绍

问题背景

在 CI 排查和 PR 状态跟踪中，常见问题不是“有没有 GitHub API”，而是如何从当前 shell 快速得到可用信息：哪个 PR 的 CI 挂了、哪个 workflow run 失败、哪些 step 报错、失败日志在哪里，以及高一级命令没有直接返回的字段怎么取。github-qinghong 把这些场景收敛到 gh CLI 的一组查询动作上，适合在没有 Git 仓库目录、但仍需要查询远端仓库状态时操作。

工作方式

  • PR 与 CI 状态：围绕 Pull Request 查询 CI 状态、最近 workflow runs、run 详情，并查看失败 step 的日志。
  • API 补充查询：当 gh 的常规子命令拿不到目标字段时，用 gh api 访问更细粒度的 GitHub API 数据。
  • 结构化输出：多数命令支持 --json，配合 --jq 过滤字段，减少人工解析。

适用边界

该技能更适合只读排查、日志定位和字段提取，不覆盖本地代码修改、分支创建或完整 PR 创建流程。使用时需要注意：不在 Git 目录中时，应显式提供 --repo owner/repo，或直接使用仓库/PR URL；查询结果仍受当前 gh 登录身份、网络连通性和 GitHub 权限限制。

使用场景

  • 排查某 PR 的 CI 失败原因时，查看 workflow run 和失败 step 日志。
  • 在非 Git 目录中查询指定 owner/repo 的最近 workflow runs。
  • 用 gh api 和 --jq 提取 PR 中缺失的字段，便于继续分析。

适合人员

  • 负责 CI 排障的工程师，需要快速定位失败 step 和对应日志。
  • 维护 monorepo 的工程师，需要按仓库或 PR 查询 workflow 状态。
  • 编写 GitHub 查询脚本的工程师，需要用 --json 和 --jq 提取字段。
  • 处理 PR 审查的工程师，需要确认目标 PR 的 CI 是否通过。