用途:借助 gh 命令行工具与 GitHub 仓库、议题(issues)、拉取请求(PR)和 CI 交互,适合在终端中完成日常 GitHub 操作与查询。
主要能力:
- 拉取请求:列出 PR、查看详情、检查 CI 状态、创建与合并 PR。
- 议题:列出、创建、关闭议题。
- CI/工作流:列出近期运行、查看指定运行、仅查看失败步骤日志、重跑失败任务。
- API 查询:用 gh api 获取指定字段、列出标签、读取仓库统计。
- 结构化输出:多数命令支持 --json 配合 --jq 过滤。
必要用法: 先认证并验证: gh auth login gh auth status
常用示例: gh pr list --repo owner/repo gh pr checks 55 --repo owner/repo gh pr create --title "feat: add feature" --body "Description" gh issue list --repo owner/repo --state open gh run list --repo owner/repo --limit 10 gh run view <run-id> --repo owner/repo --log-failed gh run rerun <run-id> --failed --repo owner/repo gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'
限制与注意:不在 git 目录中时需始终指定 --repo owner/repo;可直接使用 URL,如 gh pr view https://github.com/owner/repo/pull/55;存在速率限制,重复查询可用 gh api --cache 1h。资料未提供收费、价格、平台支持范围等更多信息。