用途:该技能用于借助 gh CLI 与 GitHub 进行交互,处理议题(issues)、拉取请求(PRs)、CI 运行以及通过 API 完成的高级查询。
主要能力与使用方式:
- 拉取请求与 CI:可用 gh pr checks 55 --repo owner/repo 查看某个 PR 的 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 api 命令适合访问其他子命令无法提供的数据,例如 gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login' 获取 PR 的指定字段。
- 结构化输出:多数命令支持 --json 输出结构化数据,并可配合 --jq 过滤,例如 gh issue list --repo owner/repo --json number,title --jq '.[] | "(.number): (.title)"'。
- 仓库定位:当不在 git 目录中时,始终指定 --repo owner/repo,或直接使用 URL。
适用场景:需要在命令行中检查 PR 的 CI 状态、浏览和排查工作流运行、获取失败日志,以及通过 API 查询 GitHub 数据并进行 JSON 过滤输出的场景。
限制:资料未提供安装方式、认证要求、权限范围、速率限制及其他使用限制,暂未提供。