agentleFS
k3forxk3forx/skills/watch-ci/SKILL.md

watch-ci

Skill1 starsChanged 4 months agoApache-2.0View on GitHub

CI/テスト監視(Monitor ツール)→ 全CI完了時のみデスクトップ通知+報告(途中経過は通知しない)

6 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

1 rule. 0 are common, 0 are distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 6 edited versions we read keep these.

  • 0

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Write ツールで /tmp/watch-ci-{PR_NUMBER}.sh に以下のスクリプトを保存する。前回実行の残骸ファイルが残っていると Write が File has not been read yet で失敗するため、Write の前に必ず Read ツールで …

    line 114

“Common” is measured: kept by at least 6 in 10 of the 6 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

watch-ci skill

概要

PR(URL / OWNER/REPO#番号 / 番号)を指定してCIをMonitorツールで監視し、全CIが完了したタイミングで初めて通知・報告するskillです。途中経過(pending、個別失敗の検知など)は通知しません。監視対象のリポジトリを必ず特定し --repo で固定するため、複数リポジトリをまたぐ環境でも取り違えません。

主要機能

  • PR URL / OWNER/REPO#番号 / PR番号 から監視対象(リポジトリ + PR番号)を特定
    • 重要: 監視対象リポジトリ (OWNER/REPO) を必ず特定し、gh の全コマンドに --repo で明示する。cwd 依存で解決させない(後述の失敗事例の根本原因)
  • Monitor ツールでCI監視(ただし出力は完了/タイムアウト/致命的エラー時のみ)
  • 30秒間隔でポーリング(デフォルトタイムアウト: 15分)
    • gh pr checks は 1 回 1 API コールで軽量なため、30秒間隔でもレート制限の心配はない
    • 間隔を粗くすると「CI は終わっているのに通知が来ない」ラグ(最大で間隔分)が発生するので、180秒などに広げないこと
  • 完了時に結果を/tmp/ci-result-{PR}.jsonに保存
  • macOSデスクトップ通知は完了時(成功/失敗)・タイムアウト時・致命的エラー時のみ送信
  • CI失敗時にログ確認を提案

通知ポリシー

イベントデスクトップ通知Claude からユーザーへ報告
pending(進行中)送らないしない
一部 fail を検知(他は pending)送らないしない
全チェック完了(pass)送るする
全チェック完了(fail あり)送るする
タイムアウト送るする
致命的エラー(リポジトリ/PR解決不能・到達不可)送るする

引数

  • TARGET: 監視対象(必須)。次のいずれかの形式で受け付ける:
    • PR URL(推奨): https://github.com/OWNER/REPO/pull/123(#discussion_... 等の末尾は無視)→ リポジトリも一意に決まるため最も安全
    • OWNER/REPO#123: リポジトリ明示
    • 123: PR番号のみ。この場合のみ cwd の git remote からリポジトリを推定する(複数リポジトリをまたぐ環境では誤解決の危険があるため、推定結果を必ず提示して検証する)
    • 引数を完全に省略した場合: cwd のカレントブランチに紐づく PR を gh pr view --json number,headRepositoryOwner,headRepository -q '"\(.headRepositoryOwner.login)/\(.headRepository.name)#\(.number)"' で解決する。コンテキスト(直前の draft-pr 等)から PR 番号をハードコードしないこと(取り違えの温床になるため、必ず cwd から実値を引く)
  • TIMEOUT_MIN: タイムアウト時間(分、デフォルト: 15)。引数で明示されなければ必ず 15 を使う。会話文脈(「CI が長い PR だから」等)から推測して 20/30 分などに変えないこと(ユーザーが延長したいときは引数で渡す)。延長が必要だった場合は完了報告時に /watch-ci {PR} 30 での再実行を案内する。

複数 PR を一括で渡された場合(例: /goal から args: "6029 6032" のように空白区切りで複数の TARGET が来る): 1 つの Monitor にまとめず、PR ごとに Step 1〜4 を独立に実行する。各 TARGET を空白で分割し、それぞれで リポジトリ/PR 番号の解決・検証(Step 1)→ スクリプト生成(Step 2、/tmp/watch-ci-{PR}.sh は PR 番号ごとに別ファイル)→ Monitor 起動(Step 3)→ 結果対応(Step 4)を回す。自前のループスクリプトを 1 つ書いて複数 PR を回さないこと(PR ごとに結果ファイル・通知のロジックが欠落するため)。各 PR は別々の Monitor タスクとして並行に走ってよい。

なぜリポジトリ特定が必須か(根本原因): gh pr checks 123 は --repo を省くと cwd の git remote からリポジトリを解決する。Monitor ツールはセッションのメイン作業ディレクトリ(例: repos/foo = OWNER/foo)でスクリプトを実行するため、別リポジトリ(例: 別の OWNER/bar)の PR を番号だけで監視すると、存在しない PR を問い合わせ続けて 「ずっと pending」のままタイムアウトする。worktree で対話的に gh を叩いた cwd と Monitor の cwd がズレるとこれが起きる。必ず OWNER/REPO を確定し --repo を全コマンドに付ける。

実装フロー

Step 1: 監視対象(リポジトリ + PR番号)の解決と検証

最重要: ここで REPO(OWNER/REPO)と PR_NUMBER を確定し、Monitor に渡す前に そのリポジトリで PR が実在することを検証する。検証に失敗したら監視を一切開始しない(誤リポジトリのまま監視を始めると無駄にタイムアウトするため、ここで早期に弾く)。

TARGET="$1"   # PR URL / OWNER/REPO#123 / 123 のいずれか

# --- 入力形式からリポジトリと PR 番号を解決(zsh/bash 両対応のため sed/grep を使用)---
if printf '%s' "$TARGET" | grep -qE '^https?://github\.com/[^/]+/[^/]+/pull/[0-9]+'; then
  REPO=$(printf '%s' "$TARGET" | sed -E 's#^https?://github\.com/([^/]+/[^/]+)/pull/[0-9]+.*#\1#')
  PR_NUMBER=$(printf '%s' "$TARGET" | sed -E 's#^https?://github\.com/[^/]+/[^/]+/pull/([0-9]+).*#\1#')
elif printf '%s' "$TARGET" | grep -qE '^[^/]+/[^/#]+#[0-9]+$'; then
  REPO=$(printf '%s' "$TARGET" | sed -E 's/#[0-9]+$//')
  PR_NUMBER=$(printf '%s' "$TARGET" | sed -E 's/^.*#([0-9]+)$/\1/')
elif printf '%s' "$TARGET" | grep -qE '^[0-9]+$'; then
  PR_NUMBER="$TARGET"
  REPO=$(gh repo view --json nameWithOwner -q .nameWithOwner 2>/dev/null)   # ← cwd 依存。番号のみ指定時の唯一の手段
  echo "ℹ️ PR番号のみ指定: cwd から '${REPO}' と推定しました(別リポジトリのPRなら URL で再指定してください)"
else
  echo "❌ エラー: TARGET は PR URL / OWNER/REPO#123 / 123 のいずれかで指定してください"; exit 1
fi

if [ -z "$REPO" ] || [ -z "$PR_NUMBER" ]; then
  echo "❌ エラー: リポジトリ/PR番号を解決できませんでした (REPO='${REPO}', PR='${PR_NUMBER}')"; exit 1
fi

# --- そのリポジトリで PR が実在するか検証し、対象を提示(取り違え防止のバナー)---
BANNER=$(gh pr view "$PR_NUMBER" --repo "$REPO" \
  --json number,title,url,headRefName,state \
  -q '"監視対象: \(.url)\n  \(.title)  [\(.headRefName), \(.state)]"' 2>/dev/null)
if [ -z "$BANNER" ]; then
  echo "❌ エラー: ${REPO} に PR #${PR_NUMBER} が見つかりません(リポジトリ取り違えの可能性)。URL 形式で指定し直してください"
  exit 1
fi
echo "$BANNER"

検証で表示された 監視対象: <URL> が意図したPRと一致することを確認してから次へ進む。一致しなければ URL 形式で指定し直す。

引数が上記4形式のいずれにも合致しない自由テキストの場合(例: PR #5974 (proj-123) commit 61b77fb796): 文字列中の最初の数字列を PR 番号候補として抽出し、リポジトリは cwd の git remote(gh repo view --json nameWithOwner -q .nameWithOwner)で補完する。その上で必ず Step 1 の gh pr view --repo 検証バナーを表示し、取り違えていないかユーザーに確認させる。番号を抽出できない/検証バナーが空(PR が実在しない)の場合は推測で続行せず、URL 形式での再指定を促してエラー終了する。

Step 2: 監視スクリプト生成

Write ツールで /tmp/watch-ci-{PR_NUMBER}.sh に以下のスクリプトを保存する。前回実行の残骸ファイルが残っていると Write が File has not been read yet で失敗するため、Write の前に必ず Read ツールで /tmp/watch-ci-{PR_NUMBER}.sh を読む。

  • Read が成功した(=残骸あり)→ 読み取り状態が確立するので、そのまま Write で上書きする。
  • Read が「ファイルが無い」旨のエラー/system-reminder を返した(=残骸なし)→ そのまま Write で新規作成する。

どちらの場合も Write は成功する。rm -f などの Bash による事前削除は使わない。この環境では rm -f は単体・複合(; echo done の付加なども含む)を問わずほぼ確実に権限フックに deny され、掃除の役に立たないまま毎回 1 往復を浪費するだけだと実績上わかっている(スクリプトは末尾の trap cleanup EXIT で自身を自己削除するため、通常そもそも残骸は発生しない)。

フローを途中で放棄しない: 権限拒否・一時的なツールエラーなど小さな障害が起きても、この Step 2〜4 の構造化フロー(Write → Monitor でスクリプト実行 → /tmp/ci-result-{PR}.json 生成 → デスクトップ通知)を捨てて、Monitor にインラインのポーリングコマンドを直接渡す・自前の待機ループを組む等の即興方式へ切り替えないこと。切り替えると結果ファイルが生成されず、通知ポリシー(完了時は必ず通知)も破られる。復旧手段は上記 Read→Write のみで十分。

重要: Step 1 で確定した REPO をスクリプトに埋め込み、gh pr checks には 必ず --repo "$REPO" を付ける({REPO} を置換)。

置換するのは {PR_NUMBER} {REPO} {TIMEOUT_MIN} の 3 つの {...} プレースホルダだけ。$0 / $SCRIPT_PATH / $BASH_SOURCE などの shell 変数はそのまま残すこと。過去、自己削除用の $0 を裸の PR 番号文字列(例 "2089")に誤置換して監視スクリプトが /tmp に残存する不具合が複数回再発している。cleanup() は必ず rm -f "$ERRFILE" "$SCRIPT_PATH" の形のまま出力する。Write 後は、生成ファイルに SCRIPT_PATH="$0" の行がそのまま残っているかを機械的に確認する(例: grep -F 'SCRIPT_PATH="$0"' /tmp/watch-ci-{PR_NUMBER}.sh が 1 行返るか)。返らなければ $0 を PR 番号などに誤置換しているので Write し直す。

#!/bin/bash
# 設計方針: 途中経過は一切出力しない。完了 / タイムアウト / 致命的エラー時のみ、
# Monitor に向けて 1 行を echo し、osascript でデスクトップ通知を出す。
# gh はカレントディレクトリの remote からリポジトリを解決するため、必ず --repo を明示し
# cwd に依存させない(依存させると別リポジトリの PR を監視できずタイムアウトする)。
PR_NUMBER="{PR_NUMBER}"
REPO="{REPO}"                  # 例: OWNER/REPO(必須・cwd 非依存)
SCRIPT_PATH="$0"               # スクリプト自身のパス。{PR_NUMBER}/{REPO} と違い置換しない(後述)。cleanup の自己削除に使う
TIMEOUT_SEC=$(({TIMEOUT_MIN} * 60))
INTERVAL=30
MAX_CONSEC_FAIL=5             # 一時障害がこの回数連続したら中断(黙ってタイムアウトまで待たない)
CONSEC_FAIL=0
START_TIME=$(date +%s)
ERRFILE="/tmp/watch-ci-${PR_NUMBER}.err"

# 終了時(完了/タイムアウト/エラー/中断いずれも)に内部スクラッチ(.err)と本スクリプト自身を
# 自動削除し、/tmp にゴミを残さない。結果ファイル(.json)は Step 4 で参照するため残す
# (同一PRなら上書きされるので累積しない)。trap は echo 出力の後に走るため Monitor 連携に影響しない。
cleanup() { rm -f "$ERRFILE" "$SCRIPT_PATH"; }
trap cleanup EXIT

notify() { osascript -e "display notification \"$2\" with title \"$1\" sound name \"$3\"" 2>/dev/null; }

while true; do
  ELAPSED=$(($(date +%s) - START_TIME))
  if [ $ELAPSED -gt $TIMEOUT_SEC ]; then
    echo '{"status":"timeout","repo":"'"$REPO"'","elapsed_min":'$((TIMEOUT_SEC/60))'}' > /tmp/ci-result-${PR_NUMBER}.json
    notify "PR #${PR_NUMBER} - Timeout" "CI監視がタイムアウトしました ($((TIMEOUT_SEC/60))分)" "Basso"
    echo "[TIMEOUT] $((TIMEOUT_SEC/60))分経過 - タイムアウト (${REPO} #${PR_NUMBER})"
    exit 1
  fi

  OUT=$(gh pr checks "$PR_NUMBER" --repo "$REPO" --json name,state,bucket 2>"$ERRFILE")
  ERR=$(cat "$ERRFILE" 2>/dev/null)

  # (1) 致命的: PR/リポジトリが解決できない → 即中断(リポジトリ取り違え等。タイムアウトまで黙って待たない)
  if echo "$ERR" | grep -qiE 'could not resolve to a (pullrequest|repository)|no pull requests found|404|not found'; then
    echo '{"status":"error","reason":"not_found","repo":"'"$REPO"'"}' > /tmp/ci-result-${PR_NUMBER}.json
    notify "PR #${PR_NUMBER} - Error" "リポジトリ/PRを解決できません: ${REPO}" "Basso"
    echo "[ERROR] ${REPO} #${PR_NUMBER} を解決できません: $(echo "$ERR" | head -1)"
    exit 2
  fi

  # (2) JSON配列として読めない → 一時障害として境界付きリトライ(pending を誤検知しないよう配列判定で分岐)
  if ! echo "$OUT" | jq -e 'type=="array"' >/dev/null 2>&1; then
    CONSEC_FAIL=$((CONSEC_FAIL+1))
    if [ "$CONSEC_FAIL" -ge "$MAX_CONSEC_FAIL" ]; then
      echo '{"status":"error","reason":"unreachable","repo":"'"$REPO"'"}' > /tmp/ci-result-${PR_NUMBER}.json
      notify "PR #${PR_NUMBER} - Error" "CI状態の取得に${MAX_CONSEC_FAIL}回連続で失敗" "Basso"
      echo "[ERROR] ${MAX_CONSEC_FAIL}回連続でCI状態取得に失敗 (${REPO} #${PR_NUMBER})"
      exit 3
    fi
    sleep $INTERVAL
    continue
  fi
  CONSEC_FAIL=0

  TOTAL=$(echo "$OUT" | jq 'length')
  if [ "$TOTAL" -eq 0 ]; then
    # チェック未登録(push直後など)。中間状態として静かに待機
    sleep $INTERVAL
    continue
  fi

  PENDING=$(echo "$OUT" | jq '[.[] | select(.bucket == "pending")] | length')
  PASS=$(echo "$OUT" | jq '[.[] | select(.bucket == "pass")] | length')
  FAIL=$(echo "$OUT" | jq '[.[] | select(.bucket == "fail")] | length')

  if [ "$PENDING" -gt 0 ]; then
    # 途中経過 (一部失敗を検知していても) は出力しない。全完了を待つ
    sleep $INTERVAL
    continue
  fi

  # 全チェック完了
  FAILED_NAMES=$(echo "$OUT" | jq -r '[.[] | select(.bucket == "fail") | .name] | join(", ")')

  jq -n \
    --arg status "completed" \
    --arg repo "$REPO" \
    --argjson pass "$PASS" \
    --argjson fail "$FAIL" \
    --argjson elapsed_min "$((ELAPSED / 60))" \
    --arg failed_names "$FAILED_NAMES" \
    '{status:$status,repo:$repo,pass:$pass,fail:$fail,elapsed_min:$elapsed_min,failed_checks:$failed_names}' \
    > /tmp/ci-result-${PR_NUMBER}.json

  if [ "$FAIL" -gt 0 ]; then
    notify "PR #${PR_NUMBER} - Failed" "❌ ${FAIL} checks failed: ${FAILED_NAMES}" "Basso"
    echo "[COMPLETE:FAIL] ❌ ${FAIL} failed: ${FAILED_NAMES} / ${PASS} passed (${REPO} #${PR_NUMBER}, 経過: $((ELAPSED/60))分)"
  else
    notify "PR #${PR_NUMBER} - Success" "✅ All checks passed (${PASS} passed)" "Glass"
    echo "[COMPLETE:PASS] ✅ All ${PASS} checks passed (${REPO} #${PR_NUMBER}, 経過: $((ELAPSED/60))分)"
  fi
  exit 0
done

Step 3: Monitor ツールで実行

Monitor ツールを使用して監視スクリプトを実行する。Bash(run_in_background) は使用しない。

Monitor は deferred tool(セッション開始時はスキーマ未ロード)。呼び出す前に ToolSearch("select:Monitor") でスキーマをロードすること。ロードせずに Monitor を呼ぶと InputValidationError になる。

Monitor: bash /tmp/watch-ci-{PR_NUMBER}.sh

注意: Monitor の timeout_ms はスクリプト側のタイムアウト(TIMEOUT_MIN)より 1〜2 分長く設定する。Monitor 側が先に切れると、スクリプトの [TIMEOUT] 通知すら届かなくなる。

Step 4: Monitor からの出力に応じた対応

スクリプトは設計上、完了またはタイムアウトのとき以外、何も出力しない。よって Monitor から行が届いた時点で必ず終了イベントである。

出力パターン対応
[COMPLETE:PASS]✅ 成功を報告
[COMPLETE:FAIL]❌ 失敗を報告し、失敗チェックのログ確認を提案
[TIMEOUT]⏰ タイムアウトを報告
[ERROR]🛑 致命的エラーを報告。reason:not_found はリポジトリ/PR取り違え(URL で再指定を促す)、reason:unreachable は GitHub 到達不可(少し待って再実行を促す)

重要: 中間ログ ([PROGRESS] / [WAITING] / [FAIL_DETECTED] / [RETRY]) は意図的に廃止した。Monitor からの行を受け取った瞬間が「全 CI 完了 / タイムアウト / 致命的エラー」の合図。ポーリング中の状態をユーザーや会話に流さないこと。

結果ファイル形式

/tmp/ci-result-{PR}.json:

{
  "status": "completed",
  "repo": "OWNER/REPO",
  "pass": 2,
  "fail": 0,
  "elapsed_min": 8,
  "failed_checks": ""
}

status は completed / timeout / error のいずれか。error のときは reason(not_found = リポジトリ/PR取り違え、unreachable = GitHub到達不可)が入る。

生成物のライフサイクル(後始末)

ファイルいつ消えるか
/tmp/watch-ci-{PR}.sh(監視スクリプト)監視終了時に trap ... EXIT で自己削除
/tmp/watch-ci-{PR}.err(内部スクラッチ)同上で自動削除
/tmp/ci-result-{PR}.json(結果)Step 4 で参照するため残す。同一PRで上書きされるので累積しない。手動で消す場合は rm -f /tmp/ci-result-*.json

macOS の /tmp(=/private/tmp) は既定で時間ベースの自動削除が無効。結果JSON以外はスクリプトが自分で片付けるため /tmp にゴミは残らない。

デスクトップ通知

成功時

タイトル: PR #{PR_NUMBER} - Success
メッセージ: ✅ All checks passed (2 passed)
サウンド: Glass

失敗時

タイトル: PR #{PR_NUMBER} - Failed
メッセージ: ❌ 1 checks failed: build
サウンド: Basso

タイムアウト時

タイトル: PR #{PR_NUMBER} - Timeout
メッセージ: CI監視がタイムアウトしました (15分)
サウンド: Basso

使用例

# PR URL から監視(推奨。リポジトリも一意に決まり取り違えが起きない)
/watch-ci https://github.com/OWNER/REPO/pull/8109

# OWNER/REPO#番号 形式(リポジトリ明示)
/watch-ci OWNER/REPO#5966

# PR番号のみ(cwd の git remote からリポジトリを推定。複数リポジトリ環境では URL 推奨)
/watch-ci 8109

# タイムアウトを30分に設定
/watch-ci https://github.com/OWNER/REPO/pull/8109 30

複数リポジトリをまたいで作業する環境では、PR番号だけの指定は誤リポジトリ解決のリスクがある。原則 URL か OWNER/REPO#番号 で指定する。

出力例

🔍 CI監視を開始しました(Monitor ツール使用)

PR番号: #8109
タイムアウト: 15分
確認間隔: 30秒

監視中... **全CIが完了する** か **タイムアウトする** まで通知しません(途中経過は流しません)。
結果ファイル: /tmp/ci-result-8109.json

gh pr checks のフィールド

重要: スクリプト生成時は必ず以下のフィールドを使用する。

# ✅ 正しい: --repo を必ず付け、name,state,bucket を使用(stderr は握りつぶさず分類に使う)
OUT=$(gh pr checks "$PR_NUMBER" --repo "$REPO" --json name,state,bucket 2>"$ERRFILE")

# ❌ 間違い1: --repo 省略(cwd 依存でリポジトリを取り違える=本スキルの過去の障害原因)
# CHECKS=$(gh pr checks "$PR_NUMBER" --json name,state,bucket 2>/dev/null)
# ❌ 間違い2: status, conclusion フィールドは存在しないため使用禁止
# CHECKS=$(gh pr checks "$PR_NUMBER" --json name,status,conclusion 2>/dev/null)

bucket フィールドの値: "pending" / "pass" / "fail" / "skipping"

skipping は GitHub Actions の if: 条件等で条件付きスキップされた完了済み check であり、wait の対象外(完了扱い)。スクリプトは pending のみを未完了として待機し、それ以外(pass / fail / skipping)が出揃ったら「全チェック完了」と判定する。

exit code の挙動(重要): --json 指定時、全 pass なら exit 0、fail 含むと exit 1、pending 残りは exit 8 を返すが、いずれも stdout には JSON 配列が出る。PR/リポジトリを解決できないときだけ exit 非0 かつ stdout は空・stderr に Could not resolve to a PullRequest/Repository が出る。よって「致命的エラーか否か」は exit code でなく stderr の文言と stdout が配列かで判定する(exit code で判定すると pending を取得失敗と誤認する)。

エラーハンドリング

エラー対策
TARGET の形式が不正エラーメッセージ表示して終了
リポジトリ/PRを解決できないStep 1 で検証し、開始前にエラー表示して終了(監視を始めない)
監視中に PR/リポジトリ解決不能[ERROR] reason:not_found で即中断(タイムアウトまで待たない)
gh pr checks の一時失敗(ネット等)リトライ。MAX_CONSEC_FAIL 回連続したら [ERROR] reason:unreachable で中断
タイムアウト結果ファイルに保存して通知

トラブルシューティング

デスクトップ通知が表示されない

原因: ターミナルに通知権限がない

対策:

  1. システム環境設定 > 通知 > ターミナル で権限確認
  2. 結果ファイル(/tmp/ci-result-{PR}.json)を確認

CI はとっくにグリーンなのに通知が来ず、最後はタイムアウトする(過去の実障害)

原因: 監視対象リポジトリの取り違え。 gh pr checks 123 を --repo 無しで実行すると cwd の git remote からリポジトリを解決する。Monitor はセッションのメイン cwd(例 repos/foo = OWNER/foo)で動くため、別リポジトリ(例 別の OWNER/bar)の PR を番号だけで監視すると、OWNER/foo 側に存在しない PR #123 を問い合わせ続け、gh は exit 非0(Could not resolve to a PullRequest)。旧スクリプトは 2>/dev/null でこれを握りつぶし「取得失敗=中間状態」として黙ってリトライし続け、本来グリーンの CI を一度も見ないままタイムアウトしていた(worktree で対話的に叩いた cwd と Monitor の cwd がズレると発生)。

対策(現行スクリプトで対処済み):

  1. Step 1 で 必ず REPO(OWNER/REPO)を確定し、gh の全コマンドに --repo "$REPO" を付ける。URL か OWNER/REPO#番号 で指定すれば一意に決まる
  2. 監視開始前に gh pr view --repo で PR の実在を検証し、監視対象: <URL> バナーを表示して取り違えを早期に弾く
  3. 監視ループは stderr を見て 致命的エラー(解決不能)を即 [ERROR] で中断し、タイムアウトまで黙って待たない
  4. 既に走っている監視がこの症状なら、止めて gh pr checks <PR> --repo <OWNER/REPO> を手動実行し、正しいリポジトリで再監視する

CI は終わっているのに通知が来ない(少し遅れる)

原因: ポーリング間隔分のラグ。CI 完了の検知は最大で INTERVAL 秒遅れる(旧版は 180 秒間隔だったため最大 3 分遅れていた。現行は 30 秒間隔)

対策:

  1. スクリプト生成時に INTERVAL=30 になっていることを確認(180 などに広げない)
  2. それでも来ない場合は監視タスクが生きているか確認し、gh pr checks {PR} --repo {OWNER/REPO} を手動実行して状態を直接確認する

CI監視がタイムアウトする

原因: CI実行時間が設定したタイムアウトを超える

対策: タイムアウトを延長して再実行

/watch-ci 8109 30  # 30分に延長

監視済み PR に新しいコミットを push した後、もう一度 CI を見たい(再監視)

手順: 特別な操作は不要。最初の監視と同じく /watch-ci {TARGET} を再度呼ぶだけでよい。監視スクリプトは起動のたびに gh pr checks でその時点の最新の CI 状態を取得するため、レビュー修正コミットなどで push し直した後の新しい CI をそのまま監視できる(結果ファイルは同一 PR なら上書きされ累積しない)。同一セッションで直前に Step 1 の検証(gh pr view バナー)を通した同じ PR の再監視なら、確定済みの REPO/PR_NUMBER を再利用して Step 2〜4(Write → Monitor)だけ回してよい。別 PR・別リポジトリ・別セッションでは Step 1 の解決と検証から実行する(取り違え防止のため)。

やってはいけないこと: Step 2 のスクリプトを手動で複製・Write したり、sleep 45 && gh pr checks ... のような自前の待機ループを組んだりしないこと。sleep とコマンドの連結はハーネスのポリシーでブロックされるうえ、Monitor ツールを使う本スキルの通知ポリシー(全完了時のみ通知)から外れてしまう。再監視も必ず /watch-ci の再実行(= Monitor ツール経由)で行う。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.