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
- OpenEnroth/OpenEnroththeir own version, first seen Oct 9, 2026
- sd0xdev/sd0x-dev-flowtheir own version, first seen Oct 8, 2026
- codervisor/lean-spectheir own version, first seen Oct 8, 2026
- sd0xdev/sd0x-harnesstheir own version, first seen Oct 6, 2026
- rezendefabio/financas-labtheir own version, first seen May 30, 2026
- codervisor/leanspectheir own version, first seen May 20, 2026
Other versions6 projects use a version of this.
Word for word · 0
None found.
Edited · 0
None found.
Wrote their own version · 6
- OpenEnroth/OpenEnroth★ 890same name
- codervisor/lean-spec★ 296same name
- codervisor/leanspec★ 294same name
- sd0xdev/sd0x-dev-flow★ 192same name
- sd0xdev/sd0x-harness★ 192same name
- rezendefabio/financas-lab★ 0same name
How matches are found. Word for word: the exact same text. Edited: shares passages with this file (“99% same” means 99% of its five-word phrases also appear here; 10% or more counts). Their own version: similar meaning, or, weakest, the same name. We can’t tell which project had it first. Projects are counted among the 200 most-starred candidates, and mentions are links to the repository we found, up to 50 per site, so both counts are a floor.
In this repository9 other files it gives its agents.
- CLAUDE.mdCLAUDE.md
- ai-updatesSkill
- brew-upgradeSkill
- claude-code-updatesSkill
- draft-prSkill
- go-updatesSkill
- read-google-sheetSkill
- summarize-blogSkill
- summarize-go-issueSkill
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
- Very specific: line 114
Write ツールで /tmp/watch-ci-{PR_NUMBER}.sh に以下のスクリプトを保存する。前回実行の残骸ファイルが残っていると Write が File has not been read yet で失敗するため、Write の前に必ず Read ツールで …
“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.
Files
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 から実値を引く)
- PR URL(推奨):
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
doneStep 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.jsongh 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 で中断 |
| タイムアウト | 結果ファイルに保存して通知 |
トラブルシューティング
デスクトップ通知が表示されない
原因: ターミナルに通知権限がない
対策:
- システム環境設定 > 通知 > ターミナル で権限確認
- 結果ファイル(
/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 がズレると発生)。
対策(現行スクリプトで対処済み):
- Step 1 で 必ず
REPO(OWNER/REPO)を確定し、ghの全コマンドに--repo "$REPO"を付ける。URL かOWNER/REPO#番号で指定すれば一意に決まる - 監視開始前に
gh pr view --repoで PR の実在を検証し、監視対象: <URL>バナーを表示して取り違えを早期に弾く - 監視ループは stderr を見て 致命的エラー(解決不能)を即
[ERROR]で中断し、タイムアウトまで黙って待たない - 既に走っている監視がこの症状なら、止めて
gh pr checks <PR> --repo <OWNER/REPO>を手動実行し、正しいリポジトリで再監視する
CI は終わっているのに通知が来ない(少し遅れる)
原因: ポーリング間隔分のラグ。CI 完了の検知は最大で INTERVAL 秒遅れる(旧版は 180 秒間隔だったため最大 3 分遅れていた。現行は 30 秒間隔)
対策:
- スクリプト生成時に
INTERVAL=30になっていることを確認(180 などに広げない) - それでも来ない場合は監視タスクが生きているか確認し、
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 ツール経由)で行う。
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
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.

