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)"'