loop-on-ci について
プルリクエストのチェックを監視し、失敗を診断して、必要な CI チェックが通るまで対応するコーディングスキルです。`gh pr checks` で PR に紐づくチェック全体を確認します。
主な機能
- 01プルリクエストの全チェックを確認
- 02保留中のチェックを監視
- 03修正前に失敗原因を診断
- 04プッシュのたびに再確認
- 05フックの回避を防止
活用シーン
- 01プルリクエストの CI 状態を追跡
- 02失敗や不安定なチェックを調査
- 03プッシュ後のチェック通過を確認
インストール
コマンドをコピーしてターミナルで実行します。
$
npx skills add https:/ / github.com/ cursor/ plugins --skill loop-on-ciインストール後、Claude Code で/loop-on-ciを入力して読み込まれたか確認します。
詳細
CI を繰り返し実行する
トリガー
ブランチまたはプルリクエストを監視し、必要なチェックがすべて成功するまで CI の失敗に対処する必要があります。
正確な情報源として gh pr checks を使用してください。PR に関連付けられたすべてのチェックが含まれますが、gh run list が対象とするのは GitHub Actions のみです。
ワークフロー
- 現在のブランチに対応する PR を特定します。
- 待機する前に、現在の PR チェックを確認します。
- すでに失敗しているチェックがある場合は、まずその失敗を診断します。
- チェックが保留中の場合は、
gh pr checks --watch --fail-fastで監視します。 - プッシュのたびに PR のチェック全体を再確認し、すべて成功するまで繰り返します。
コマンド
# Resolve the active PR
gh pr view --json number,url,headRefName
# Inspect all attached checks
gh pr checks --json name,bucket,state,workflow,link
# Watch pending checks and fail fast
gh pr checks --watch --fail-fast
# GitHub Actions logs, when the failing check links to a GHA run
gh run view <run-id> --log-failed
ガードレール
- 可能な限り、各修正を単一の失敗原因に限定します。
- 進行を強制するためにフックを回避(
--no-verify)しないでください。 - 失敗が明らかに PR と無関係で、main では修正済みと思われる場合は、PR に無関係な修正を追加するのではなく、最新の main をマージします。
- 失敗が不安定な場合は、一度だけ再試行し、不安定さを示す根拠を報告します。
- プッシュのたびに
gh pr checks --json name,bucket,state,workflow,linkを再実行します。チェックの構成は変わることがあります。
出力
- 現在の CI ステータス
- 失敗の概要と適用した修正
- チェックがすべて成功した後の PR URL
コメント
Markdown 対応