gh CLI用过才知道有多爽！GitHub命令行操作全靠它，PR/Issue/Actions一把梭🔥-Skill优仓

什么是gh CLI？

如果你每天都在GitHub上提PR、管Issue、跑Actions，却还在浏览器和终端之间反复横跳，那这篇文章真的是为你写的。gh CLI是GitHub官方出品的命令行工具，版本已经更新到2.85.0，覆盖了你在GitHub上能做的几乎所有操作——仓库管理、Issue、Pull Request、GitHub Actions、Codespaces、Releases、Gists，一个命令搞定。

核心功能

gh CLI的命令体系非常清晰，按资源类型分模块，上手没有门槛。核心能力覆盖以下几大块：

仓库操作：创建、克隆、Fork、归档、同步Fork，甚至批量管理仓库标签和部署密钥。
Issue管理：创建、编辑、关闭、转移、锁定Issue，支持批量操作和复杂过滤。
Pull Request全流程：从创建Draft PR、代码Review、合并到Revert，全程不离终端。
GitHub Actions：触发Workflow、查看运行日志、下载Artifacts、管理Secrets和Variables。
Releases管理：创建版本、上传资产文件、验证签名，发版流程自动化。
API直连：通过gh api直接调用GitHub REST和GraphQL API，配合jq做数据提取，灵活度拉满。

适用平台

gh CLI作为一个Skill，完美适配当前主流AI编程助手。无论你用的是Cursor、GitHub Copilot、Claude Code、OpenAI Codex，还是Gemini Code Assist、文心快码、腾讯云CodeBuddy、华为云CodeArts，加载这个Skill之后，AI能直接理解gh命令的语法、参数和使用场景，给出精准的命令建议，不再靠猜。对于需要在AI对话中处理GitHub工作流的开发者来说，这个Skill就是最强外挂。

实操代码示例

几个最高频的使用场景，直接拿走用：

# 从Issue创建分支并提PR
gh issue develop 123 --branch feature/issue-123
git add . && git commit -m "Fix issue #123" && git push
gh pr create --title "Fix #123" --body "Closes #123"

# 批量关闭stale Issue
gh issue list --search "label:stale" --json number --jq '.[].number' | 
  xargs -I {} gh issue close {} --comment "Closing as stale"

# 触发Workflow并等待完成
gh workflow run ci.yml --ref main
gh run watch $(gh run list --workflow ci.yml --json databaseId --jq '.[0].databaseId')

用gh api调GraphQL也很顺手：

gh api graphql -f query='
{
  viewer {
    login
    repositories(first: 5) {
      nodes { name }
    }
  }
}'

优势分析

市面上也有一些第三方GitHub CLI工具，但gh CLI的优势在于官方维护、与GitHub深度集成。几个关键点：

认证体系完整：支持OAuth、Token、GitHub Enterprise，企业内网场景也能覆盖。
JSON+jq输出：几乎所有命令都支持--json和--jq，脚本化和自动化非常方便。
扩展生态：通过gh extension可以安装社区扩展，功能可以无限叠加。
与git无缝衔接：gh auth setup-git一行命令配置好credential helper，再也不用手动管token。

应用场景

以下几个场景是开发团队用得最多的：

CI/CD自动化：在脚本里用GH_TOKEN环境变量驱动gh CLI，自动触发部署流程、下载构建产物、发布Release。
Issue分诊：用gh issue list --search配合jq过滤，快速找到需要处理的Issue并批量打标签。
代码Review提效：gh pr checkout 123直接切到PR分支本地跑，gh pr review --approve一行通过，不用开浏览器。
多仓库管理：配合gh repo set-default和环境变量GH_REPO，在脚本里跨仓库操作毫无压力。
Codespaces管理：远程开发场景下，用gh codespace ssh和gh codespace cp管理云端开发环境。

最佳实践

用好gh CLI有几个工程化的关键点值得注意：

自动化场景用环境变量：CI/CD流水线里不要用交互式登录，直接设置GH_TOKEN，配合GH_PROMPT_DISABLED=true禁掉交互提示。
善用–paginate：查询Issue、PR等列表时，数据量大的情况下加上--paginate，避免只拿到第一页数据导致脚本逻辑出错。
jq过滤优先于grep：gh CLI的JSON输出结构稳定，用jq做字段提取比正则匹配更可靠，也更易维护。
设置默认仓库：在项目目录下执行gh repo set-default，后续所有命令不用重复指定--repo参数，省心很多。
Shell补全别忘了配：gh completion -s zsh > ~/.gh-complete.zsh，命令补全配好之后效率提升明显，尤其是参数多的命令。