用途:借助 GitHub 官方命令行工具 gh 与 GitHub 交互,覆盖议题(issue)、拉取请求(PR)、CI 运行和高级查询等常见操作。
主要能力:
- 拉取请求与 CI:查看 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 访问其他子命令未提供的数据,例如 gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'。
- 结构化输出:多数命令支持 --json 输出结构化数据,并可用 --jq 过滤,例如 gh issue list --repo owner/repo --json number,title --jq '.[] | "(.number): (.title)"'。
使用方式:在非 git 目录下操作时,始终显式指定 --repo owner/repo,或直接使用 URL。
限制:资料未说明身份认证、权限范围、速率限制及具体支持的 gh 版本,相关内容暂未提供。