Gh Pr Checks Plan Fix

概要

gh を使用して失敗した PR チェックを特定し、実用的な失敗の GitHub Actions ログを取得し、失敗スニペットを要約してから修正計画を提案し、明示的な承認後に実装します。

• 修正計画の草案作成と承認には plan スキルに依存します。

前提条件: gh が認証されていることを確認してください (例えば、gh auth login を1回実行してください)。その後、gh auth status を昇格された権限 (workflow/repo スコープを含む) で実行してください。これにより gh コマンドが成功します。サンドボックスが gh auth status をブロックしている場合は、sandbox_permissions=require_escalated で再実行してください。

入力

• repo: リポジトリ内のパス (デフォルト .)
• pr: PR番号またはURL (オプション; 現在のブランチの PR がデフォルト)
• gh リポジトリホストの認証

クイックスタート

• python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"
• 要約用に機械可読形式の出力が必要な場合は --json を追加してください。

ワークフロー

1. gh 認証を確認します。
   • gh auth login を実行後、昇格されたスコープ (workflow/repo) でリポジトリ内で gh auth status を実行します。
   • サンドボックスの認証状態の確認に失敗した場合、sandbox_permissions=require_escalated でコマンドを再実行してネットワーク/キーリングアクセスを許可してください。
   • 認証されていない場合は、続行する前にユーザーにログインするよう要求してください。
2. PR を解決します。
   • 現在のブランチの PR を優先: gh pr view --json number,url。
   • ユーザーが PR 番号または URL を提供した場合は、それを直接使用します。
3. 失敗したチェックを検査します (GitHub Actions のみ)。
   • 推奨: バンドルされたスクリプトを実行します (gh フィールドドリフトとジョブログフォールバックを処理):
     • python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "<number-or-url>"
     • 機械可読形式の出力の場合は --json を追加してください。
   • 手動フォールバック:
     • gh pr checks <pr> --json name,state,bucket,link,startedAt,completedAt,workflow
       • フィールドが拒否された場合は、gh が報告した利用可能なフィールドで再実行します。
     • 失敗したチェックごとに、detailsUrl から実行 id を抽出して実行します:
       • gh run view <run_id> --json name,workflowName,conclusion,status,url,event,headBranch,headSha
       • gh run view <run_id> --log
     • 実行ログが進行中であると示している場合は、ジョブログを直接フェッチします:
       • gh api "/repos/<owner>/<repo>/actions/jobs/<job_id>/logs" > "<path>"
4. GitHub Actions 以外のチェックをスコープします。
   • detailsUrl が GitHub Actions 実行でない場合、それを外部としてラベル付けし、URL のみを報告します。
   • Buildkite または他のプロバイダーを試さないでください。ワークフローをリーンに保ちます。
5. 失敗をユーザーに要約します。
   • 失敗したチェック名、実行 URL (ある場合)、および簡潔なログスニペットを提供します。
   • ログの欠落を明示的に指摘します。
6. 計画を作成します。
   • plan スキルを使用して簡潔な計画を草案作成し、承認をリクエストします。
7. 承認後に実装します。
   • 承認された計画を適用し、差分/テストを要約し、PR を開くかどうかを尋ねます。
8. ステータスを再確認します。
   • 変更後、関連するテストを再実行して gh pr checks を実行し、確認するよう提案してください。

バンドルされたリソース

scripts/inspect_pr_checks.py

失敗した PR チェックをフェッチし、GitHub Actions ログを取得し、失敗スニペットを抽出します。失敗が残っている場合はゼロ以外で終了するため、オートメーションで使用できます。

使用例:

• python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "123"
• python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --pr "https://github.com/org/repo/pull/123" --json
• python "<path-to-skill>/scripts/inspect_pr_checks.py" --repo "." --max-lines 200 --context 40