GitHub 技能
使用 gh CLI 与 GitHub 进行交互。当不在 git 目录中时,始终使用 --repo owner/repo 指定仓库,或直接使用 URL。
拉取请求
检查 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
调试 CI 失败
按照以下顺序调查 CI 运行失败:
- 检查 PR 状态 — 找出哪些检查正在失败:
gh pr checks 55 --repo owner/repo - 列出最近运行 — 找到相关的运行 ID:
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
用于高级查询的 API
gh api 命令可用于访问其他子命令无法获得的数据。
获取包含特定字段的 PR:
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
JSON 输出
大多数命令支持使用 --json 输出结构化数据。可以使用 --jq 进行过滤:
gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'