用途:通过 gh 命令行工具与 GitHub 交互,覆盖议题、拉取请求、CI 运行和高级 API 查询。
主要能力:查看 PR 的 CI 状态(gh pr checks 55 --repo owner/repo);列出近期工作流运行(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 api 访问其他子命令未提供的数据,例如获取 PR 指定字段(gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login')。
使用方式:不在 git 目录中时始终指定 --repo owner/repo,或直接使用 URL。多数命令支持 --json 输出结构化数据,并可用 --jq 过滤,例如 gh issue list --repo owner/repo --json number,title --jq '.[] | "(.number): (.title)"'。
适用场景:需要快速检查 PR 状态、排查 CI 失败、批量查询议题或 PR 信息时。
限制:资料未提供安装方式、认证要求、权限范围、速率限制及平台支持等细节。