Github

• エージェントにGithubのIssueやプルリクエストの監視またはトリアージを代行させたい場合。
• CI/CDパイプラインのステータスを確認する必要がある場合（ワークフローの実行一覧の表示、失敗したステップのログの確認、壊れたビルドの診断など）。
• ダウンストリームの処理やレポート作成のために、GithubからJSON形式の構造化された出力が必要な場合。
• 標準的なghサブコマンドでは公開されていない、GithubのREST APIエンドポイントをクエリしたい場合（例：--jqフィルターを使用して特定のPRフィールドを取得するなど）。

• Gitプロトコルレベル（クローン、コミットのプッシュ、リベース）でGithubと連携する必要がある場合 — このスキルはGithubプラットフォームAPI向けであり、生のGit操作には対応していません。
• GitLab、Bitbucket、またはその他のGithub以外のホストが必要な場合；gh CLIはGithub専用です。

gh pr checks や gh pr list などのコマンドを使用して、プルリクエストの一覧表示、詳細確認、ステータス確認を行います。--repo owner/repo を指定することで、gitディレクトリ外からでも任意のリポジトリに対して常に操作できます。

gh run list、gh run view、および --log-failed を使用して GitHub Actions のワークフロー実行を検査し、失敗したステップのログのみを表示します。手動でログを探すことなく、壊れたパイプラインを診断する必要があるエージェントに最適です。

gh api コマンドを使うと、GitHub REST API の任意のエンドポイントにアクセスできます。--jq フィルターと組み合わせることで、必要なフィールドだけを正確に抽出できます — たとえば、1回の呼び出しで PR のタイトル、状態、作成者を取得することが可能です。

ほとんどの gh サブコマンドは --json フラグをサポートしており、レスポンスを --jq 式にパイプしたり、下流のツールで直接利用したりすることができます。これにより、エージェントがGitHubのデータをプログラム的に解析して操作することが容易になります。

gh issue list を使用してイシューの一覧表示とフィルタリングを行い、構造化クエリのための JSON 出力にも対応しています。標準の gh フラグを通じて、ラベル、状態、担当者などによるフィルタリングをサポートしています。

エージェントがすべてのオープン中のPRを確認し、gh pr checksを通じてCIステータスを取得して、失敗または停滞しているPRを洗い出します。これにより、開発者は手動でダッシュボードを確認することなく、優先順位付きのリストを受け取ることができます。

ビルドが壊れたとき、エージェントは gh run view <run-id> --log-failed を実行して失敗したステップのログのみを取得し、根本原因を要約します。これにより、エンジニアが長大なCI出力をスクロールして確認する手間を省けます。

エージェントは gh issue list --json と --jq フィルターを使用してオープンなIssueを照会し、ラベル・経過日数・担当者ごとにグループ化した構造化レポートを生成して、週次チームダイジェストとして提供します。

カスタムの --jq クエリを組み合わせた gh api を使用することで、エージェントは標準のサブコマンドでは表示されない特定のメタデータ（例：PRのマージコミットSHA、レビュアーリスト、ワークフローのタイミングなど）を取得します。