GitHubCLI技能Skill 用法详解

GitHubCLI技能：在终端里用 gh 命令统一管理 Issues、PR 与 CI

• 一句话定位：把 GitHub 的日常操作搬到命令行，用一个 gh 命令完成 PR 检查、CI 运行查看、Issue 查询和高级 API 调用。
• 核心能力：支持 gh pr checks、gh run list、gh run view、gh run view --log-failed、gh api，以及几乎所有命令的 --json + --jq 结构化输出。
• 零学习负担：命令与 GitHub 官方 CLI 完全一致，会用 gh 就能用这个技能，无需额外记新语法。
• 依赖简单：只需要本机存在 gh 可执行文件，可通过 brew 或 apt 一键安装。
• 最适合：经常在终端里排查 CI 失败、审阅 PR、批量梳理 Issue 的开发者与运维同学。

该技能叫什么？如何一键安装 AI 技能提升开发效率？

这个技能的中文名是 GitHubCLI技能，英文名是 github，技能 ID 为 13590。它的 emoji 标识是 🐙，指向非常明确：GitHub 的章鱼猫。

它解决的问题其实很具体：日常开发中，很多动作被迫在浏览器和终端之间来回切换。想看看某个 PR 的 CI 过没过，要打开网页；想确认最近几次 workflow 运行哪一次挂了，要反复点进点出；想批量导出 Issue 编号和标题，只能靠复制粘贴。这个技能把这类操作收敛回命令行：用 gh CLI 与 GitHub 交互，通过 gh issue、gh pr、gh run 和 gh api 处理 issues、PRs、CI runs 以及高级查询。

安装前提

技能本身依赖本机的 gh 可执行文件（技能元数据里明确声明了 requires.bins: ["gh"]）。也就是说，先有 gh，技能才能工作。

一键安装步骤

1. 安装 GitHub CLI。技能详情中提供了两条官方推荐的安装入口：

   • macOS / Linuxbrew 环境：使用 brew 方式安装，对应 formula 为 gh，安装后用 gh 命令验证；
   • Debian / Ubuntu 环境：使用 apt 方式安装，对应包名为 gh。

   两者本质上是同一条路径的两种包管理器实现：一条命令装完，不需要手动配置 PATH。

2. 安装本技能。在支持技能安装的 AI 工具或平台中，通过技能市场、技能列表或安装入口检索「GitHubCLI技能」并安装。具体的安装命令与入口地址以官方说明为准，不同平台的入口名称可能不同。

3. 验证是否生效。

   • 先在终端执行 gh --version，确认 CLI 已经存在并可用；
   • 再执行 gh auth status 确认账号已登录，若未登录，按官方文档完成 gh auth login 授权（首次使用需要，具体流程以官方说明为准）；
   • 最后在 AI 会话中直接提出「看一下 owner/repo 这个仓库最近 10 次 workflow 运行」，如果它能给出 gh run list 的结果，说明技能已经生效。

该技能的主要功能和特点

• PR 状态速查：gh pr checks 55 --repo owner/repo 可以直接列出某个 PR 的各项检查状态，不用打开网页逐个看。
• CI 运行列表：gh run list --repo owner/repo --limit 10 拉取最近的 workflow 运行记录，快速定位最近一次失败发生在哪。
• 运行详情与失败定位：gh run view <run-id> --repo owner/repo 查看某次运行的步骤明细；加上 --log-failed 后只输出失败步骤的日志，避免被几千行成功日志淹没。
• 高级查询能力：gh api 可以访问其他子命令覆盖不到的数据，比如用 gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login' 精准取出 PR 的标题、状态和提交人。
• 结构化输出：大多数命令支持 --json，配合 --jq 过滤，可以直接产出适合二次处理的文本或管道输入。
• 不依赖当前目录：不在 git 目录时，始终显式指定 --repo owner/repo，或直接使用完整 URL 作为参数即可。

和「手动点网页」「写一堆 curl 调 REST API」相比，它的优势在于：命令更短、语义更清楚、输出可直接被脚本或 AI 消费。

如何使用该技能？

1. 确认仓库上下文。如果你当前就在目标仓库的 git 目录里，可以直接省略 --repo；否则一律带上 --repo owner/repo。
2. 查看 PR 的 CI 状态。例如：

   gh pr checks 55 --repo owner/repo
   

   输出会列出该 PR 上各个检查项及通过/失败情况，适合在合并前做最后确认。
3. 列出最近的 workflow 运行。

   gh run list --repo owner/repo --limit 10
   

   输出包含运行编号、状态、分支、事件类型等，记下失败那条的 run-id。
4. 深入某次运行。

   gh run view <run-id> --repo owner/repo
   

   能看到哪些步骤成功、哪些失败。只想看失败部分时：

   gh run view <run-id> --repo owner/repo --log-failed
   

5. 需要子命令覆盖不到的数据时，用 API。

   gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
   

   输出三行：PR 标题、状态、作者登录名。
6. 想要结构化数据时，加 --json 与 --jq。

   gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
   

   输出形如 123: 修复登录页偶发白屏 的逐行清单，便于贴进周报或继续加工。

提示：把需求直接说给 AI，比背命令更高效。例如「帮我看看 owner/repo 最近 10 次运行，哪一次失败、失败在哪个步骤」，它会自动组合 gh run list 和 gh run view --log-failed。

同类型竞品对比分析

方案名称	定位	核心功能	安装/使用门槛	适用场景	优势与不足
GitHubCLI技能（本技能）	AI 技能封装的 gh 命令行能力	PR 检查、CI 运行查看、失败日志、gh api 高级查询、--json 结构化输出	需先有 gh（brew/apt 一键装），技能侧按官方入口安装	终端内排查 CI、批量查 Issue、脚本化与自动化	优势：命令语义清楚、输出可管道处理、AI 可直接调用；不足：需具备基础命令行习惯
GitHub 网页端 / 官方 App	图形化操作入口	浏览 Issue、PR、Actions 日志	零安装，登录即用	代码评审、看日志、点按钮重跑	优势：直观、有 UI；不足：切换成本高，难以批量和自动化
原生命令 git + 手动查 CI	版本控制与本地操作	提交、分支、推送、拉取	已有 git 即可	日常提交与分支管理	优势：通用；不足：不覆盖 Issue/PR/CI 查询
gh api + curl 直连 REST API	通用 HTTP 调用	全量 API 访问	需自行处理 token 与分页	精细定制查询	优势：灵活；不足：命令冗长、可读性差，需自己拼鉴权

该技能的典型应用场景与实际体验情况

场景一：后端开发者排查 CI 失败。 提交代码后发现合并按钮灰了，痛点是打开 Actions 页面要等日志渲染、定位失败步骤很慢。用本技能先 gh run list 找到最近一次失败，再 gh run view <run-id> --log-failed 只看失败日志，通常一两分钟就能锁定问题。实际体验是"路径极短"，但要注意 run-id 需要从列表中准确取出。

场景二：开源维护者批量梳理 Issue。 维护者需要定期把待处理 Issue 整理成清单。用 gh issue list --json number,title --jq '.[] | "\(.number): \(.title)"' 一次拿到编号加标题，可读性优于默认表格输出。上手几乎零成本，前提是仓库名拼写正确。

场景三：发布负责人盯 PR 的检查状态。 发版前需要确认关键 PR 全部通过。gh pr checks 55 --repo owner/repo 一条命令给出结论，比在网页中逐个展开高效。注意命令需要正确的 PR 编号。

场景四：AI 代理或脚本做自动化。 由于大多数命令支持 --json 与 --jq，输出天然适合喂给后续流程，比如定时拉取运行列表做告警。这里的关键注意点是：不在 git 目录时务必显式指定 --repo，否则会因上下文缺失而报错。

整体体验：上手难度低（本质是标准 gh 语法），效果稳定，属于"一次学会、长期复用"的工具型技能；主要注意项集中在仓库上下文、编号准确性以及首次使用的账号授权。

该技能能为用户带来的价值

• 减少上下文切换：把 PR、Issue、CI 的查询从浏览器拉回终端，单次操作省下的几十秒，在一天几十次的排查中会累积成可观的时间。
• 降低日志阅读门槛：--log-failed 让失败日志从"几千行里找一行"变成"只看该看的那部分"。
• 让自动化变得容易：--json + --jq 把 GitHub 数据变成结构清晰的行文本，脚本和 AI 都能直接消费，长期看是把重复劳动沉淀成流程。
• 学习成本可复用：掌握的是 GitHub 官方 CLI 的通用能力，换项目、换仓库仍然适用。

常见问题 FAQ

Q1：这个技能怎么安装？ 先在系统中安装 gh，技能详情给出的方式是 brew（formula 为 gh）或 apt（包名为 gh）；然后在所用的 AI 平台按官方入口安装本技能，最后用 gh --version 验证。

Q2：收费吗？ 技能本身依赖 GitHub CLI，属于开源命令行工具，具体授权与费用以官方说明为准；本技能不涉及额外的数据存储。

Q3：不在仓库目录里还能用吗？ 可以。技能文档明确说明：不在 git 目录时，始终指定 --repo owner/repo，或直接使用 URL。

Q4：它和直接打开 GitHub 网页有什么区别？ 网页适合浏览和点按钮，本技能适合查询、过滤与自动化，尤其是把结果交给脚本或 AI 继续处理时。

Q5：适合谁用？ 经常处理 PR 与 CI 的开发者、开源维护者、负责发布与流水线排查的同学，以及希望把 GitHub 操作接入自动化流程的团队。