# Github

> 使用 `gh` CLI 与 GitHub 交互。**Auto-trigger**: 当涉及 GitHub 操作、issues、PRs、CI运行时自动使用。

- Skill: `lza6/github` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add lza6/github`
- Raw SKILL.md: https://api.skillmd.com/api/skills/lza6/github/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: lza6 (https://skillmd.com/u/lza6)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/lza6/github

---


# GitHub 技能

使用 `gh` CLI 与 GitHub 交互。不在 git 目录中时务必指定 `--repo owner/repo`，或直接用 URL。

## Pull Request

检查 PR 上的 CI 状态：
```bash
gh pr checks 55 --repo owner/repo
```

列出最近的工作流运行：
```bash
gh run list --repo owner/repo --limit 10
```

查看某次运行并检查哪些步骤失败了：
```bash
gh run view <run-id> --repo owner/repo
```

仅查看失败步骤的日志：
```bash
gh run view <run-id> --repo owner/repo --log-failed
```

## API 用于高级查询

`gh api` 命令可用于访问其他子命令无法获取的数据。

获取包含指定字段的 PR：
```bash
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'
```

## JSON 输出

大多数命令都支持 `--json` 获取结构化输出。可使用 `--jq` 进行过滤：

```bash
gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
```

