github

GitHub スキル

gh CLI を使用して GitHub と連携します。git ディレクトリ以外で使用する場合は、常に --repo owner/repo を指定するか、URL を直接使用してください。

使用する場面

• ユーザーが GitHub の issue、プルリクエスト、ワークフロー実行、CI の失敗について尋ねた場合。
• コマンドラインから gh issue、gh pr、gh run、または gh api が必要な場合。

プルリクエスト

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 実行を調査するには、次の手順に従ってください:

1. PR ステータスを確認する — どのチェックが失敗しているかを特定します:

   gh pr checks 55 --repo owner/repo
   

2. 最近の実行を一覧表示する — 該当する実行 ID を見つけます:

   gh run list --repo owner/repo --limit 10
   

3. 失敗した実行を表示する — どのジョブとステップが失敗したかを確認します:

   gh run view <run-id> --repo owner/repo
   

4. 失敗ログを取得する — 失敗したステップの詳細な出力を取得します:

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

制限事項

• このスキルは、タスクが上記の範囲に明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、または専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、または成功基準が欠けている場合は、停止して確認を求めてください。