github について
`gh` コマンドラインを使う開発者向けに、GitHub のプルリクエスト、ワークフロー実行、API データの確認を支援するスキルです。CI 失敗の段階的な調査手順と JSON の絞り込み方法を示します。
主な機能
- 01プルリクエストのチェック確認
- 02ワークフロー実行の一覧と表示
- 03失敗したステップのログ取得
- 04`gh api` による GitHub の照会
- 05`--jq` による JSON の絞り込み
活用シーン
- 01プルリクエストの失敗チェック特定
- 02失敗したワークフロー実行の追跡
- 03失敗ステップのログ確認
- 04GitHub データから指定フィールドを抽出
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ dimillian/ skills --skill githubインストール後、Claude Code で/githubを入力して読み込まれたか確認します。
同梱ファイルagents/openai.yaml
詳細
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)"'
コメント
Markdown 対応