关于 github
面向使用 `gh` 命令行的开发者,协助检查 GitHub 拉取请求、工作流运行和 API 数据。技能提供逐步排查 CI 失败的流程,并介绍结构化 JSON 筛选。
主要功能
- 01检查拉取请求状态
- 02列出并查看工作流运行
- 03获取失败步骤日志
- 04通过 `gh api` 查询 GitHub
- 05使用 `--jq` 筛选 JSON
适用场景
- 01定位拉取请求中的失败检查
- 02追踪失败的工作流运行
- 03查看失败步骤的日志
- 04提取 GitHub 数据中的指定字段
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ dimillian/ skills --skill github安装后在 Claude Code 中输入/github确认已加载。
附带文件agents/openai.yaml
详细介绍
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)"'
评论
支持 Markdown