Agent Skills
返回列表
GitHub CLI 查询助手

GitHub CLI 查询助手

开发编程 更新于 2026.08.30

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

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_dd5c5538/gith-lyx。

技能介绍

它解决什么问题

当 GitHub PR、CI 和 workflow 状态分散在不同页面时，靠浏览器反复切换成本高。gh CLI 可以直接查询 PR、run、step 和日志，但 --repo owner/repo、--json、--jq 这些常用参数组合容易记错。这个技能把这些查询路径整理成可复用的工作流，适合在终端里完成日常 GitHub 排查。

技能如何工作

技能围绕 gh CLI 组织操作：先明确目标仓库，在非 git 目录时使用 --repo owner/repo，或直接用仓库 URL；然后检查 PR 的 CI 状态，列出最近的 workflow runs，查看具体 run 中失败的 step，并只提取失败步骤日志。对于子命令未覆盖的数据，它提示使用 gh api 做高级查询，并通过 --json 输出结构化结果，再用 --jq 过滤字段。

适用边界

它主要面向已安装 gh CLI 且具备 GitHub 访问权限的场景，不包含创建、合并或管理仓库的完整流程，也不替代本地 git 操作。查询深度受账号权限、API 限流和日志可用性影响；企业内网或 SSO 环境需要单独配置认证。

使用场景

  • 在接手 PR 前，先检查 CI 状态与最近 workflow runs，判断是否已绿。
  • PR 红了以后，定位失败的 workflow run 和 step，只拉取失败步骤日志排查。
  • 在非 git 目录查指定仓库的 PR 数据时，用 --repo owner/repo 指定目标仓库。
  • 子命令查不到的 GitHub 字段时，用 gh api 请求并配合 --json/--jq 过滤。

适合人员

  • 需要盯 PR CI 状态的工程师：快速判断合并前检查是否通过。
  • 排查 workflow 失败的平台工程师：定位失败 step 并提取日志。
  • 查询 GitHub 数据的自动化脚本作者：用 gh api/JSON 获取结构化字段。
  • 维护发布流程的开发者：检查最近 runs 与失败原因。