⚡

GitHub命令行工具技能 github

GitHub 命令行工具技能，通过 `gh` CLI 高效管理 GitHub 仓库、拉取请求、问题、CI/CD 工作流和 API 查询。关键词：GitHub CLI, gh 命令, 代码仓库管理, 拉取请求, 问题跟踪, CI/CD 自动化, DevOps 工具, 命令行工具, GitHub API, 开发运维。

DevOps 0 次安装 0 次浏览 更新于 2/24/2026

name: github description: “通过 gh CLI 进行 GitHub 操作：问题、拉取请求、CI 运行、代码审查、API 查询。适用于：(1) 检查 PR 状态或 CI，(2) 创建/评论问题，(3) 列出/筛选 PR 或问题，(4) 查看运行日志。不适用于：需要手动浏览器流程的复杂 Web UI 交互（请在有条件时使用浏览器工具）、跨多个仓库的批量操作（使用 gh api 编写脚本）或 gh 身份验证未配置的情况。” metadata: { “openclaw”: { “emoji”: “🐙”, “requires”: { “bins”: [“gh”] }, “install”: [ { “id”: “brew”, “kind”: “brew”, “formula”: “gh”, “bins”: [“gh”], “label”: “安装 GitHub CLI (brew)”, }, { “id”: “apt”, “kind”: “apt”, “package”: “gh”, “bins”: [“gh”], “label”: “安装 GitHub CLI (apt)”, }, ], }, }

GitHub 技能

使用 gh CLI 与 GitHub 仓库、问题、拉取请求和 CI 进行交互。

何时使用

✅ 在以下情况使用此技能：

  • 检查 PR 状态、审查或合并准备情况
  • 查看 CI/工作流运行状态和日志
  • 创建、关闭或评论问题
  • 创建或合并拉取请求
  • 查询 GitHub API 以获取仓库数据
  • 列出仓库、版本或协作者

何时不使用

❌ 在以下情况不要使用此技能：

  • 本地 git 操作（提交、推送、拉取、分支）→ 直接使用 git
  • 非 GitHub 仓库（GitLab、Bitbucket、自托管）→ 使用不同的 CLI
  • 克隆仓库 → 使用 git clone
  • 审查实际代码变更 → 使用 coding-agent 技能
  • 复杂的多文件差异比较 → 使用 coding-agent 或直接读取文件

设置

# 身份验证（一次性）
gh auth login

# 验证
gh auth status

常用命令

拉取请求

# 列出 PR
gh pr list --repo owner/repo

# 检查 CI 状态
gh pr checks 55 --repo owner/repo

# 查看 PR 详情
gh pr view 55 --repo owner/repo

# 创建 PR
gh pr create --title "feat: 添加功能" --body "描述"

# 合并 PR
gh pr merge 55 --squash --repo owner/repo

问题

# 列出问题
gh issue list --repo owner/repo --state open

# 创建问题
gh issue create --title "Bug: 某功能损坏" --body "详情..."

# 关闭问题
gh issue close 42 --repo owner/repo

CI/工作流运行

# 列出最近运行
gh run list --repo owner/repo --limit 10

# 查看特定运行
gh run view <run-id> --repo owner/repo

# 仅查看失败步骤日志
gh run view <run-id> --repo owner/repo --log-failed

# 重新运行失败作业
gh run rerun <run-id> --failed --repo owner/repo

API 查询

# 获取具有特定字段的 PR
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

# 列出所有标签
gh api repos/owner/repo/labels --jq '.[].name'

# 获取仓库统计信息
gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

JSON 输出

大多数命令支持 --json 进行结构化输出，并可使用 --jq 过滤：

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
gh pr list --json number,title,state,mergeable --jq '.[] | select(.mergeable == "MERGEABLE")'

模板

PR 审查摘要

# 获取用于审查的 PR 概览
PR=55 REPO=owner/repo
echo "## PR #$PR 摘要"
gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \
  --jq '"**\(.title)** 由 @\(.author.login)

\(.body)

📊 +\(.additions) -\(.deletions) 跨越 \(.changedFiles) 个文件"'
gh pr checks $PR --repo $REPO

问题分类

# 快速问题分类视图
gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \
  --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'

注意事项

  • 不在 git 目录中时，始终指定 --repo owner/repo
  • 直接使用 URL：gh pr view https://github.com/owner/repo/pull/55
  • 适用速率限制；对于重复查询，使用 gh api --cache 1h