github

GitHub スキル

gh CLI を使用して、GitHub のリポジトリ、Issue、PR、CI を操作します。

使用する場面

✅ 次の場面でこのスキルを使用します：

• PR のステータス、レビュー、マージ可能かどうかを確認する
• CI／ワークフローの実行状況やログを表示する
• Issue を作成、クローズ、またはコメントする
• プルリクエストを作成またはマージする
• GitHub API でリポジトリのデータを照会する
• リポジトリ、リリース、コラボレーターを一覧表示する

使用しない場面

❌ 次の場面ではこのスキルを使用しないでください：

• ローカルの Git 操作（commit、push、pull、branch）→ git を直接使用します
• GitHub 以外のリポジトリ（GitLab、Bitbucket、セルフホスト環境）→ 別の CLI を使用します
• リポジトリのクローン → git clone を使用します
• 実際のコード変更のレビュー → coding-agent スキルを使用します
• 複雑な複数ファイルの差分 → coding-agent を使用するか、ファイルを直接読みます

セットアップ

# Authenticate (one-time)
gh auth login

# Verify
gh auth status

よく使うコマンド

プルリクエスト

# List PRs
gh pr list --repo owner/repo

# Check CI status
gh pr checks 55 --repo owner/repo

# View PR details
gh pr view 55 --repo owner/repo

# Create PR
gh pr create --title "feat: add feature" --body "Description"

# Merge PR
gh pr merge 55 --squash --repo owner/repo

Issue

# List issues
gh issue list --repo owner/repo --state open

# Create issue
gh issue create --title "Bug: something broken" --body "Details..."

# Close issue
gh issue close 42 --repo owner/repo

CI／ワークフローの実行

# List recent runs
gh run list --repo owner/repo --limit 10

# View specific run
gh run view <run-id> --repo owner/repo

# View failed step logs only
gh run view <run-id> --repo owner/repo --log-failed

# Re-run failed jobs
gh run rerun <run-id> --failed --repo owner/repo

API クエリ

# Get PR with specific fields
gh api repos/owner/repo/pulls/55 --jq '.title, .state, .user.login'

# List all labels
gh api repos/owner/repo/labels --jq '.[].name'

# Get repo stats
gh api repos/owner/repo --jq '{stars: .stargazers_count, forks: .forks_count}'

JSON 出力

ほとんどのコマンドでは、--json で構造化出力を取得し、--jq でフィルタリングできます：

gh issue list --repo owner/repo --json number,title --jq '.[] | "\(.number): \(.title)"'
gh pr list --json number,title,state,mergeable --jq '.[] | select(.mergeable == "MERGEABLE")'

テンプレート

PR レビューの概要

# Get PR overview for review
PR=55 REPO=owner/repo
echo "## PR #$PR Summary"
gh pr view $PR --repo $REPO --json title,body,author,additions,deletions,changedFiles \
  --jq '"**\(.title)** by @\(.author.login)\n\n\(.body)\n\n📊 +\(.additions) -\(.deletions) across \(.changedFiles) files"'
gh pr checks $PR --repo $REPO

Issue のトリアージ

# Quick issue triage view
gh issue list --repo owner/repo --state open --json number,title,labels,createdAt \
  --jq '.[] | "[\(.number)] \(.title) - \([.labels[].name] | join(", ")) (\(.createdAt[:10]))"'

メモ

• Git ディレクトリ内にいない場合は、必ず --repo owner/repo を指定します
• URL を直接使用できます：gh pr view https://github.com/owner/repo/pull/55
• レート制限が適用されます。同じクエリを繰り返す場合は gh api --cache 1h を使用します