github-skill

GitHub スキル - PR とコードレビュー

GitHub のプルリクエストや Issue の読み取り、検索、管理を行います。レビューの確認、CI ステータスの確認、通知の追跡ができます。

セットアップ不要

このスキルでは、すでに認証済みのはずの gh CLI を使用します。次のコマンドで確認してください。

gh auth status

コマンド

オープン PR の一覧表示

python3 ~/.claude/skills/github-skill/github_skill.py prs [--repo OWNER/REPO] [--mine] [--limit N] [--state STATE]

引数：

• --repo / -r - owner/repo 形式のリポジトリ（Git リポジトリ内にいる場合は省略可能）
• --mine / -m - 自分の PR のみを表示
• --limit / -l - 結果の件数（デフォルト：20）
• --state / -s - 絞り込み：open、closed、merged、all（デフォルト：open）

PR の詳細を取得

python3 ~/.claude/skills/github-skill/github_skill.py pr NUMBER [--repo OWNER/REPO] [--format FORMAT]

引数：

• NUMBER - PR 番号
• --repo / -r - リポジトリ
• --format / -f - 出力形式：json（デフォルト）または vault（メモ用の Markdown）

PR のレビューコメントを取得

python3 ~/.claude/skills/github-skill/github_skill.py pr-comments NUMBER [--repo OWNER/REPO]

PR のレビューを取得

python3 ~/.claude/skills/github-skill/github_skill.py pr-reviews NUMBER [--repo OWNER/REPO]

自分のレビュー待ち PR

python3 ~/.claude/skills/github-skill/github_skill.py review-requests [--repo OWNER/REPO] [--limit N]

朝会の準備に最適です。自分にレビューが依頼されているすべての PR が表示されます。

Issue の一覧表示

python3 ~/.claude/skills/github-skill/github_skill.py issues [--repo OWNER/REPO] [--mine] [--limit N] [--state STATE]

Issue の詳細を取得

python3 ~/.claude/skills/github-skill/github_skill.py issue NUMBER [--repo OWNER/REPO]

自分のリポジトリの一覧表示

python3 ~/.claude/skills/github-skill/github_skill.py repos [--limit N]

未読通知

python3 ~/.claude/skills/github-skill/github_skill.py notifications [--limit N]

ワークフローの例

朝会の準備

# See what PRs need your review
python3 ~/.claude/skills/github-skill/github_skill.py review-requests

# Check status of your open PRs
python3 ~/.claude/skills/github-skill/github_skill.py prs --mine

次の情報が表示されます。

• 自分のレビュー待ち PR（CI ステータス付き）
• 自分のオープン PR（レビュー判定付き）

朝会での共有例：「Andre の PR（EPO-428）をレビュー（CI 通過、承認待ち）」

特定の PR を確認

# Get full details
python3 ~/.claude/skills/github-skill/github_skill.py pr 123 --repo epochml/epoch

# See review comments
python3 ~/.claude/skills/github-skill/github_skill.py pr-comments 123 --repo epochml/epoch

# Get vault-formatted markdown
python3 ~/.claude/skills/github-skill/github_skill.py pr 123 --repo epochml/epoch --format vault

Linear と相互参照

PR のタイトルには Linear の Issue ID（例：「EPO-428: Fix manifest flattening」）が含まれていることがよくあります。このスキルは、出力内でこれらを自動的に抽出します。

{
  "number": 123,
  "title": "EPO-428: Fix manifest flattening",
  "linear_id": "EPO-428",
  ...
}

Linear スキルと組み合わせて使用します。

# Get PR details
python3 ~/.claude/skills/github-skill/github_skill.py pr 123 --repo epochml/epoch

# Get Linear issue details
python3 ~/.claude/skills/linear-skill/linear_skill.py issue EPO-428

出力

すべてのコマンドはデフォルトで JSON を出力します。--format vault オプション（pr コマンド用）を指定すると、Obsidian のメモに適した Markdown が出力されます。

## PR #123: EPO-428: Fix manifest flattening

**Status:** OPEN, Changes Requested
**Author:** @andre
**Linear:** EPO-428
**Link:** [epochml/epoch#123](https://github.com/epochml/epoch/pull/123)

### Checks
- CI: OK
- lint: OK

### Reviews
- @idan: CHANGES_REQUESTED - "Need to handle edge case..."

出力フィールド

PR 一覧の出力

{
  "number": 123,
  "title": "EPO-428: Fix manifest flattening",
  "author": {"login": "andre"},
  "state": "OPEN",
  "reviewDecision": "CHANGES_REQUESTED",
  "linear_id": "EPO-428",
  "checks_summary": "5 passed, 1 pending",
  "url": "https://github.com/epochml/epoch/pull/123"
}

レビュー判定の値

• APPROVED - マージ可能
• CHANGES_REQUESTED - 対応が必要
• REVIEW_REQUIRED - レビュー待ち
• null - まだレビューなし

要件

• gh CLI がインストールされ、認証済みであること
• Python 3.9+

セキュリティに関する注意

• 既存の gh CLI 認証を使用します
• このスキルに認証情報は保存されません
• gh auth status の権限を継承します