SuperAPI AI 工具集

gh-cli

编程与开发

查看项目

更新于 10-16 07:15

技能介绍

用途 本技能提供 GitHub CLI(gh)的完整命令参考,适合需要在终端中操作 GitHub 的场景,例如管理仓库、议题、拉取请求、Actions 工作流运行、发布、密钥和 API 请求。资料以 v2.87.3(2026 年 2 月)为文档基准,使用前建议先核对版本:gh --version;若版本差异较大,部分命令或标志可能已变化,可用 gh help <command> 确认。

主要能力 覆盖常用命令组:auth(登录、切换账号、setup-git)、repo(创建、克隆、查看、fork、sync)、issue(创建、列表、查看、评论、develop 建分支)、pr(创建、查看、评论、审查、diff、checks、合并)、run 与 workflow(查看日志、watch、rerun、手动触发)、search(代码、提交、议题、PR)、api(直接调用 REST/GraphQL)、project、release、gist、codespace、secret、variable、extension、alias 等。

使用方式 安装可用 brew install gh(macOS),随后 gh auth login 认证,gh auth setup-git 配置 git,gh auth status 验证。脚本中推荐使用 --json 与 --jq 输出结构化数据,例如 gh pr list --author @me --json number,title;大数据集使用 --paginate;CI 中可设置 GH_TOKEN 环境变量,如 export GH_TOKEN=$(gh auth token)。gh run watch 配合 --exit-status 可在失败时返回非零退出码。其他环境变量包括 GH_HOST、GH_REPO、GH_EDITOR、GH_PAGER、GH_PROMPT_DISABLED。

适用场景 适合从终端提 PR、查看 CI 状态、批量关闭过期议题、打标签、创建发布并上传资源、管理 CI 密钥等。

限制 资料未提供各参考文件的完整细则、具体错误处理、权限范围与收费信息,均暂未提供。创建 Actions 的 YAML 文件不属于本技能范围,本技能仅覆盖与既有 workflow 和 run 交互的 CLI 命令。