watch-ci Skill | Agent Skills

watch-ci

[!NOTE] この作業は安い AI Model で済ませたいので、あなたが高価な Model であれば以降の作業は安い Model の SubAgent に移譲してください.

push または PR 作成後の CI を監視し、失敗したら re-run を試みてから原因をトリアージし、適切なスキルで修正してパスするまでループする。

Procedure

1. コンテキスト確認

git branch --show-current
gh pr view --json number,url,headRefName 2>/dev/null

2. PR チェック一覧を取得して失敗を検出

PR が存在する場合: gh run list ではなく gh pr checks を使うこと。 gh run list --limit 1 はブランチ上の最後に起動した run しか見ないため、複数 workflow が走るリポジトリでは失敗した run を見逃す原因になる。

# PR に紐づく全チェックの状態を取得
gh pr checks --json name,status,conclusion,link 2>/dev/null

判定:

conclusion=failure のチェックが 1 件でもある → 失敗。リンクから run ID を取得して Step 3 へ。
全件が success / skipped / neutral → 成功。完了レポートを出して終了。
status=in_progress / queued が残っている → 待機してリトライ。

PR が存在しない場合: 直近 5 件の run を確認する。

gh run list --branch "$(git branch --show-current)" --limit 5 \
  --json databaseId,status,conclusion,url,workflowName

いずれも run が存在しない場合（push 直後）は 5 秒待って最大 6 回再試行する。 6 回試しても run が現れなければユーザーに報告して終了する。

失敗 run の ID は gh pr checks のリンク URL から取得する:

# リンク例: https://github.com/owner/repo/actions/runs/12345678/job/...
# run ID は runs/ と /job の間の数値
gh pr checks --json link --jq '[.[] | select(.conclusion=="failure") | .link | capture("runs/(?P<id>[0-9]+)") | .id] | unique'

3. CI run を監視

Bash tool に background 実行のためのパラメータがある場合明示的に background 実行すること。

gh run watch <run-id> --compact

4. 失敗時: re-run を試みる

失敗した job だけを再実行する：

gh run rerun <run-id> --failed

re-run の結果を監視する： Bash tool に background 実行のためのパラメータがある場合明示的に background 実行すること。

gh run watch <new-run-id> --compact

passing with re-run: → flaky として記録し Step 2 に戻る（次の run を監視）。
- 完了レポートの Flaky 欄に記録する。
re-run and failed again: → Step 5 に進む。

5. 失敗トリアージ: PR 影響箇所との関連チェック

re-run しても失敗する場合、CI の失敗が PR の変更と関連しているかどうかを判定する。

# PR の変更ファイル一覧を取得
gh pr view --json files --jq '[.files[].path]'

# 失敗ログを取得してファイルパス・エラー箇所を確認
gh run view <run-id> --log-failed

判定基準:

失敗ログに含まれるファイルパスやディレクトリが PR 変更ファイルと重複する → 関連あり
重複なし、または失敗が依存関係解決・インフラ・外部サービス系の step → 関連なし（flaky 疑い）

判定結果によるルーティング:

関連あり → fix-github-actions-ci スキルを呼び出す。このスキルが原因特定・修正・commit/push まで完走する。
関連なし → investigate-flaky-test スキルを呼び出す。調査レポートをユーザーに提示して終了する。

6. 修正後: ループ

fix-github-actions-ci による修正 push 完了後、Step 2 に戻って新しい run を取得・監視する。

ループ終了条件:

CI がパスした → 成功レポートを出して終了
flaky として記録し re-run でパスした → 成功レポート（flaky 注記付き）を出して終了
investigate-flaky-test が完了した → 調査レポートをユーザーに渡して終了
同一ブランチで fix-github-actions-ci による修正を 3 回試みたが CI が改善しない → ユーザーに報告して終了（無限ループ防止）
ユーザーが停止を指示した

完了レポート

CI Watch Report
  Branch  : <branch>
  PR      : <url>
  Result  : ✅ passed | ✅ passed (flaky rerun) | ❌ failed after <N> attempts
  Runs    : <run-url-1>, <run-url-2>, ...
  Flaky   : <flaky が検出された場合のみ> <step-name> (rerun passed on <run-url>)

Agent Skills: watch-ci

Install this agent skill to your local

Skill Files