一、什么是 gh ？一句话：它就是你终端里的 GitHub 超级中枢
很多开发者初次接触 gh 时，常常误以为它只是 git 的附属品——用来简化 git push 或者减少鼠标操作。但实际用下来才发现，它的能力远不止如此。
到了 2026 年，gh 早已超越了“命令行版的 GitHub”这一概念。它俨然成为 AI 时代开发者手中的轻量级操作系统——能够统一调度 GitHub 上的仓库、PR、Issue、Actions，乃至你为 AI 配置的各项技能。听起来很抽象？不妨先看看你日常工作中常见的三大“效率黑洞”。
你肯定被这三个黑洞折磨过
| 黑洞 | 具体表现 | AI 解决方案 |
|---|---|---|
| 工具切换频繁 | 在编辑器、浏览器、终端、GitHub 网页间不断切换，一天下来注意力支离破碎 | 终端 + gh 一站式解决 |
| 重复劳动 | 反复编写 PR 描述、排查 CI 错误、手动 Review 代码，机械性工作耗费大量时间 | AI 自动生成 + gh 自动化 |
| 知识碎片化 | 每个 AI 工具都有各自的技能和配置，Claude 装一遍、Cursor 再装一遍，管理混乱 | gh skill 统一管理 |
这三个黑洞，gh 一个工具就能填平。
二、gh 的三大无可替代的核心能力
1. gh 是 GitHub 官方推出的命令行工具，功能全面且由专业团队持续维护，天然与 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 # 锁定版本，避免意外更新它远不止安装功能那么简单。每个技能的来源、版本号和修改记录都清晰可查。
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，中间用 | 管道串联，自动化流程便浑然天成。
