用途:借助 gh 命令行工具与 GitHub 仓库、issue、PR 及 CI 交互。适用场景包括检查 PR 状态、审查与可合并性,查看 CI/工作流运行状态与日志,创建、关闭或评论 issue,创建或合并 pull request,查询 GitHub API 获取仓库数据,以及列出仓库、发布或协作者。不适用场景:本地 git 操作(commit、push、pull、分支)应直接用 git;非 GitHub 仓库(GitLab、Bitbucket、自托管)使用其他 CLI;克隆仓库用 git clone;审查实际代码改动、复杂多文件 diff 应使用 coding-agent 技能或直接读取文件。准备:一次性执行 gh auth login 认证,用 gh auth status 验证。常用能力:PR 方面可 gh pr list、gh pr checks 55 --repo owner/repo、gh pr view、gh pr create、gh pr merge 55 --squash;Issue 方面可 gh issue list --state open、gh issue create、gh issue close 42;CI 方面可 gh run list --limit 10、gh run view <run-id>、gh run view <run-id> --log-failed、gh run rerun <run-id> --failed;API 查询可 gh api repos/owner/repo/pulls/55 --jq 提取字段、列出标签、读取仓库统计。多数命令支持 --json 结构化输出并配合 --jq 过滤,例如按可合并状态筛选 PR。注意事项:不在 git 目录时应始终指定 --repo owner/repo;可直接传入 URL;存在速率限制,重复查询可用 gh api --cache 1h。官方说明中未提供其他收费、平台或功能细节。
github
编程与开发
更新于 10-16 09:59