gh：终端里的GitHub总控台，AI时代的开发者神器

一、 gh 到底是什么？简单说：它是你终端里的 GitHub"总控台"

我刚开始了解 gh 的时候以为它只是 git 的一个小跟班------用来替代 git push 或者省两下鼠标点击。但后来发现，完全不是。

2026 年的 gh，早就不再是"命令行的 GitHub"那么简单了。它其实是 AI 时代开发者桌面上的一个轻量级操作系统------专门用来调度 GitHub 上的一切：仓库、PR、Issue、Actions，甚至你给 AI 装的各种技能包。

听上去有点抽象？没关系，我们从你每天都会遇到的三个"黑洞"说起。

你肯定被这三个黑洞折磨过

黑洞	表现	AI 解法
工具切换	编辑器→浏览器→终端→GitHub 网页，来回跳，一天下来脑子都切碎了	终端 + gh 全部搞定
重复劳动	写 PR 描述、排 CI 错误、手动 Review，同样的活干一百遍	AI 自动生成 + gh 自动化
知识碎片	每个工具的技能/规则/配置各管各的，Claude 装一遍、Cursor 再装一遍	gh skill 统一管理

这三个黑洞，gh 一个工具就能填平。

二、gh 的三大不可替代能力

1. gh 是 GitHub 官方 CLI，功能覆盖最全、团队长期维护，并且天然与 GitHub 的各种新特性（如 Agent Skills）同步更新。

别的 AI 工具（比如 Copilot CLI）最多给你建议一条命令，让你自己复制粘贴去执行。gh 不一样------它是直接上手干。

# 创建 PR，不用开浏览器
gh pr create --title "feat: 用户认证" --body "AI 生成"

# 看我名下有哪些未处理的 Issue
gh issue list --assignee @me --state open

# CI 失败了？直接看日志，不用点页面
gh run view 1234 --log-failed

# 合并 PR 顺便删分支
gh pr merge 42 --delete-branch

一句话总结：凡是你在 GitHub 网页上能点鼠标做的事，gh 都能用一行命令完成。

2. gh skill 的优势在于更安全的供应链管理和与 GitHub 原生能力的深度集成。

现在 AI 编程工具多得要命：Claude Code、Cursor、Copilot......每个都有自己的技能目录，手动装一遍能累死。

gh skill 就是来解决这个问题的------一条命令，全工具生效。

gh skill search "code review"           # 搜索技能
gh skill install vercel-labs/agent-skills  # 安装
gh skill list                           # 看看装了哪些
gh skill lock                           # 锁住版本，防止偷偷更新

而且它不止是装一下那么简单。每个技能从哪里来、什么版本、谁改过------全都有记录可查。

顺带提一句 ：findskills 和上面两个工具是什么关系？

简单说，npx skills 和 gh skill 是底层的"包管理器" （类似于 npm），findskills 是 AI 的"搜索代理"（AI 自己不知道怎么搜索的时候就靠它）。

findskills 本质上是一个 Skill 本身，它的作用是教会 AI "如何帮用户搜索和安装其他技能"。它依赖 npx skills CLI 来执行具体的搜索和安装动作。

三者配合起来是这样的：你问 AI "有没有 React 性能优化的技能" → AI 调用 findskills → findskills 调用 npx skills find（或 gh skill search）→ 返回结果 → AI 推荐给你。

而 gh skill 的出现，让这个流程又多了一个选择：你可以不用 npx skills，而是直接 gh skill install。两者的技能是通用的，你选哪个取决于你的偏好。

3. gh 的命令设计天然支持结构化输出（--json + --jq），让它特别适合作为自动化管道中的一环，能轻松串联查询、筛选、操作、批量处理等多个步骤。

这是 gh 最被低估的能力：它天生适合放在管道（pipe）里，和 AI 以及其他命令组合。

给你看几个真实例子：

场景一：PR 自动审查

gh pr diff 42 | claude "审查安全漏洞" | gh pr comment 42 --body -

一行命令：取出 PR 的代码差异 → 扔给 Claude 审查 → 把审查结果自动评论到 PR 里。

场景二：CI 失败自动排查

gh run view 1234 --log-failed | claude "分析原因并给出修复命令"

场景三：会议记录一键转 Issue

cat meeting.txt | claude "提取行动项" | gh issue create --body -

你看，gh 在这里扮演的是"胶水"角色------它把 AI 的能力和 GitHub 上的实际操作无缝粘在一起。

三、重点来了：gh skill 到底解决了什么痛点？

你可能已经听说过 Skills------它不是 Prompt 也不是插件，而是一份 给 AI 看的"入职手册"。一个 Skill 就是一个文件夹，里面装着：

• SKILL.md：告诉 AI 怎么做某件事（比如"如何做 React 代码审查"）
• scripts/：可执行的脚本
• references/：参考资料

但问题是：Skills 这个生态刚起来的时候，大家都是手动下载、手动复制到各个工具的目录里。装一个两个还好，装十个八个就乱了------哪个版本？从哪里来的？更新了什么？一概不知。

gh skill 把这套流程产品化了：

问题	手动管理	gh skill 管理
技能从哪来的？	不知道	来源可追溯
装的哪个版本？	不知道	gh skill history
更新了什么？	不知道	签名验证 + 变更审计
多工具同步？	各装各的，累死	一装全通
CI/CD 里能用吗？	基本不能	gh skill run 直接跑

甚至在 CI 流水线里，你都可以自动装技能、自动跑审查：

# .github/workflows/skills-review.yml
- name: Install skills
  run: |
    gh skill install @team/code-review
    gh skill install @team/security-scan
- name: Run code review
  run: gh skill run @team/code-review --path ./src

四、安装与配置

gh 安装（Windows）

# 方式 1：winget（推荐）
winget install GitHub.cli

# 方式 2：手动下载 MSI
# 访问 https://github.com/cli/cli/releases
# 下载 gh_X.XX.X_windows_amd64.msi（注意选 amd64，不是 arm64！）
# 双击安装，重启终端

gh 认证

# 方式 1：浏览器登录（推荐）
gh auth login
# 选择 GitHub.com → HTTPS → Login with a web browser

# 方式 2：Token 登录（无浏览器时）
# 先生成 Token：GitHub → Settings → Developer settings → Personal access tokens
echo "ghp_你的token" | gh auth login --with-token

# 验证
gh auth status

验证安装成功

gh --version        # 确认版本 >= 2.14
gh auth status      # 确认已登录
gh skill list       # 确认 skill 命令可用

五、总结

gh 不是什么炫酷的新技术，它就是一个让你少切几十次浏览器、少点几百次鼠标、少复制粘贴一堆命令的工具。

但它真正的价值，是在 AI 时代把它变成了一个"枢纽"：

• 左边连着你的终端和 AI
• 右边连着 GitHub 上的仓库、PR、Issue、Actions
• 中间用 | 管道一接，自动化就出来了