github について
`gh` コマンドラインでGitHubのプルリクエスト、ワークフロー実行、APIデータを確認するスキルです。リポジトリ作業を行うエージェント向けに、CI確認やJSONの絞り込み例を含みます。
主な機能
- 01プルリクエストのCI状態確認
- 02ワークフロー実行の一覧と確認
- 03失敗ステップのログ取得
- 04GitHub APIフィールドの照会
- 05構造化JSON出力の絞り込み
活用シーン
- 01プルリクエストのCI結果確認
- 02ワークフロー失敗の原因調査
- 03指定したプルリクエスト項目の取得
- 04JSONから課題一覧を整形
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ mitsuhiko/ agent-stuff --skill githubインストール後、Claude Code で/githubを入力して読み込まれたか確認します。
詳細
GitHub スキル
GitHub とやり取りするには gh CLI を使用します。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
高度なクエリ向け 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 対応