关于 github
此 Skill 指导使用 `gh` 命令行处理 GitHub Issue、拉取请求、工作流运行和 API 查询,适用于仓库事务与 CI 故障排查。
主要功能
- 01检查拉取请求状态
- 02列出并查看工作流运行
- 03获取失败步骤日志
- 04查询 GitHub API 数据
- 05筛选 JSON 结构化输出
适用场景
- 01排查 CI 运行失败
- 02检查拉取请求状态
- 03查找 Issue 或拉取请求
- 04用 `gh api` 查询仓库字段
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ sickn33/ agentic-awesome-skills --skill github安装后在 Claude Code 中输入/github确认已加载。
附带文件agents/openai.yaml
详细介绍
GitHub 技能
使用 gh 命令行与 GitHub 交互。当不在 git 目录中时,始终指定 --repo owner/repo,或直接使用 URL。
何时使用
- 当用户询问 GitHub issue、拉取请求、工作流运行或 CI 失败时。
- 当你需要从命令行使用
gh issue、gh pr、gh run或gh 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
调试 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