| name | watch-pr |
| description | PR push 直後 / PR 作成後の auto chain (`/create-pr` のフェーズ 6.2 から発動) / CI 監視 / レビュー対応 / merge 前確認 の文脈で発動。`gh pr checks` を一度 polling し green / red / pending を集計、 red なら失敗 job のログを fetch して「format drift / test fail / build error / flake / contract drift」に分類。 同時に unresolved review thread (人間 / Copilot) も集計し、 安全カテゴリ (stale / Copilot style ノイズ) は `/reply-review --auto-safe` を auto chain で起動して reply + resolve まで自動完了。 人間 reviewer / blocker 候補は user 判断のため提示のみ。 `/loop /watch-pr <PR>` で継続監視に使える。 |
| argument-hint | [pr-number] |
| disable-model-invocation | false |
| allowed-tools | Bash(gh pr checks *) Bash(gh pr view *) Bash(gh run view *) Bash(gh api *) Bash(git rev-parse *) Bash(git branch *) Read Grep Skill |
PR CI Status Watcher
PR の CI checks を 1 回ポーリングして状態を集計する skill。継続監視は /loop と組み合わせる:
/loop /watch-pr 489 # 5 分間隔で polling、red/green/timeout で通知
/watch-pr # 引数省略時は現在ブランチに紐づく PR を自動検出
引数
$1 (任意): PR 番号 (例: 489)。省略時は gh pr view --json number で現在ブランチから自動取得
実行前の確認
- ブランチ: !
git rev-parse --abbrev-ref HEAD
- 引数: $ARGUMENTS
手順
フェーズ 1: PR 番号の確定
引数 $1 がない場合、現在ブランチに紐づく PR を取得:
PR_NUM=$(gh pr view --json number --jq '.number' 2>/dev/null)
該当 PR がない場合 (= まだ push していない / PR 未作成) は、その旨をユーザーに報告して停止。
フェーズ 2: CI checks の一括取得
gh pr checks "$PR_NUM" --json name,state,conclusion,link --jq '.[]'
各 check は以下の状態のいずれか:
- state:
QUEUED / IN_PROGRESS / COMPLETED
- conclusion (COMPLETED 時のみ):
SUCCESS / FAILURE / CANCELLED / SKIPPED / NEUTRAL / TIMED_OUT / ACTION_REQUIRED
フェーズ 3: 集計とサマリ
以下のテーブルでサマリを表示 (件数は実際の集計値):
## PR #<N> CI Status (<HH:MM:SS>)
| State | Count |
|--------------|-------|
| ✅ Success | <n> |
| ❌ Failure | <n> |
| 🔁 Pending | <n> |
| ⏭️ Skipped | <n> |
| ⚠️ Cancelled | <n> |
Total: <total> checks
判定ルール:
- All green (failure=0, pending=0, cancelled=0): 「全 N checks green、merge 可能状態」
- Red (failure ≥ 1): フェーズ 4 へ
- Pending (queued/in_progress ≥ 1): 「N checks がまだ走行中、再度 polling を推奨」
- Suspicious skip (cancelled+skipped が 3 件以上連続): silent skip の可能性を警告 (PR #419 事例)
フェーズ 4: 失敗 job の分析 (failure ≥ 1 時のみ)
各失敗 job について:
- job 名と link を表示
gh run view <run-id> --log-failed で失敗 step のログを fetch (最大 100 行)- ログを以下の pattern で分類:
- Format drift:
ruff cargo fmt gofmt dotnet format clippy 系のエラー → ローカル pre-commit run --all-files で修復可能
- Test fail:
FAILED assert panicked expected 系 → どのテストかを抽出
- Build error:
error[E0 cannot find undefined reference 系 → コンパイルエラー
- Flake:
timeout network connection reset rate limit 系 → 一過性、retry 推奨
- Contract drift:
MISMATCH OUT OF SYNC byte-for-byte 系 → 該当 check-* skill を案内
- 分類別に推奨アクションを提示
フェーズ 5: Unresolved review thread の集計
CI status とは独立で、 review コメント / Copilot 指摘が未解決のまま残っていないか
を毎回チェック。 /check-review-backlog --pr <PR> 相当の GraphQL を呼ぶ:
gh api graphql -f query='
query($owner: String!, $name: String!, $number: Int!) {
repository(owner: $owner, name: $name) {
pullRequest(number: $number) {
reviewThreads(first: 50) {
nodes {
isResolved
isOutdated
comments(first: 1) {
nodes {
author { login }
path
body
createdAt
}
}
}
}
}
}
}' -F owner=ayutaz -F name=piper-plus -F number="$PR_NUM" --jq \
'.data.repository.pullRequest.reviewThreads.nodes
| map(select(.isResolved == false))
| length, map(select(.isResolved == false))[]'
集計:
- Unresolved 0 件: review 障害なし、 next phase へ
- Unresolved ≥ 1 件:
-
reviewer 別 (human / Copilot bot) に分類
-
stale check: 該当 file がそのコメント以降に修正済みか (memory feedback_copilot_stale_review)
-
提案テーブル形式で表示:
## Unresolved Review Threads (#<PR>)
| # | Reviewer | Path | Stale? | 提案 |
|---|----------|------|--------|------|
| 1 | Copilot | src/foo.py:42 | ✓ stale (b7e71c8 以降に更新済) | dismiss / reply |
| 2 | yousan | src/bar.rs:88 | new | 修正 → `/reply-review <PR>` |
フェーズ 5.5: 安全カテゴリの自動 reply + resolve (auto-chain)
Unresolved review thread が 1 件以上ある場合、 必ず/reply-review <PR> --auto-safe
を Skill tool で chain 起動する。 これにより以下が自動処理される (フェーズ 1.9
参照、 SAFE-stale / SAFE-copilot-style の 2 カテゴリ):
- SAFE-stale: コメント以降に該当 file が更新済 → 「修正済 (commit
<hash>)」 reply + resolve
- SAFE-copilot-style: Copilot bot の style noise (
^Consider (using|renaming)\b 等) → 「style 提案は本 PR の scope 外」 reply + resolve
--auto-safe は SAFE 系のみ実行、 REVIEW-human / REVIEW-copilot-blocker は
内部で dry-run 扱いとなり提示のみ。 これにより:
- ユーザの介入なく Copilot のノイズコメントと stale 指摘を片付ける
- 人間 reviewer の本質的な指摘と Copilot の logic / security 指摘は user 判断に残す
- memory
feedback_pr_body_over_comments (PR body 改変ルール) は review thread reply には適用外、 feedback_merge_caution (merge 前確認) も merge ≠ resolve のため抵触しない
skill 呼び出し:
Skill({skill: "reply-review", args: "<PR_NUM> --auto-safe"})
戻り値の reply / resolve カウントを次フェーズの判定材料にする。
フェーズ 6: 次のアクション提案
| 状態 | 推奨アクション |
|---|
| All green + Unresolved 0 (自動 resolve 後含む) | /check-pr-ready で最終確認、 user 確認後に merge (gh pr merge --auto 禁止) |
| All green + REVIEW 残 ≥ 1 (自動処理外) | user に judge を促し、 修正コミット後再度 /loop /watch-pr <PR> |
| Red (format drift) | pre-commit run --all-files をローカル実行、修正後 /commit |
| Red (test fail) | 該当テストファイル名を提示、/run-tests <scope> で再現 |
| Red (build error) | エラーログを示してユーザーに方針確認 |
| Red (flake) | gh run rerun <run-id> --failed を提示 (ユーザー確認後実行) |
| Red (contract drift) | /check-pua /check-loanword 等の該当 skill を提示 |
| Pending | /loop /watch-pr <PR> で継続監視 (auto-safe は次回 iteration でも走る) |
継続監視モード
ユーザーが「green になるまで監視して」と希望する場合:
/loop /watch-pr <PR>
/loop skill が /watch-pr <PR> を再帰的に呼び出す。 各 iteration で本 skill が
CI + review thread を両方確認。 終了条件:
| iteration の結果 | アクション |
|---|
| All green + Unresolved 0 | ユーザーに完了通知して /loop を終了 |
| All green + Unresolved ≥ 1 | フェーズ 5.5 で /reply-review --auto-safe を chain 起動。 SAFE 系は自動 reply + resolve、 残った REVIEW 系を user に提示して /loop を終了 |
| Red (本物) | 失敗分析を表示して /loop を終了 (人間判断が必要) |
| Red (flake のみ) | gh run rerun --failed を提案 (確認後実行)、 ループは継続 |
| Pending | 次の polling 間隔まで sleep (自動 pace は CI 状況で 4-20 分、 cache TTL の都合で IN_PROGRESS 多い時は delaySeconds=270、 落ち着いた状態なら 1200+)。 各 iteration でも review thread の auto-safe chain は走る |
SAFE 系 review thread の自動 reply + resolve は本 skill のフェーズ 5.5 で行う。
REVIEW-human / REVIEW-copilot-blocker は memory feedback_pr_body_over_comments /
feedback_merge_caution 遵守のため user 判断に委ね、 修正後にユーザが明示的に
/reply-review <PR> を起動する形。
注意事項
- 無限ループ防止: 4 時間以上 pending が続くケースは
/loop を終了して人間に確認を促す
- rate limit: GitHub API は 5000 req/hour、 ポーリング間隔を 1 分未満にしない
- silent skip: cancelled+skipped が連続 3 以上は path filter による意図的 skip かもしれないが、 PR #419 事例のように baseline が silent に skip されることがあるので警告
- 失敗ログ取得失敗時:
gh run view が 404 を返す場合 (job がまだ完了していない等) はスキップ
- merge は user-only: 本 skill から
gh pr merge を実行することは禁止 (memory feedback_merge_caution に従う)
- review reply は SAFE 系のみ自動: フェーズ 5.5 で
/reply-review --auto-safe を chain 起動。 SAFE-stale / SAFE-copilot-style だけ自動 reply + resolve。 REVIEW-human / REVIEW-copilot-blocker は user 判断のため /reply-review <PR> 明示起動を待つ
- 自動コード修正は行わない: review 指摘で「コードを直す」 必要があるものは user 判断。 stale (既に修正済) / Copilot ノイズ (style 提案) のみ自動 reply で完結
- Copilot stale 検出: review コメント以降に同 file が更新済なら
stale フラグ付き提示 (memory feedback_copilot_stale_review)。 自動 reply の core ロジック
使用例
# 現在ブランチの PR を 1 回チェック
/watch-pr
# PR #489 を 1 回チェック
/watch-pr 489
# 5 分間隔で継続監視 (loop skill が pace 決定)
/loop /watch-pr 489
# 固定 5 分間隔
/loop 5m /watch-pr 489
期待効果
- ユーザーが 7 ランタイム × ~94 jobs の CI を手動で
gh pr checks ポーリングする手間を削減
- red 時に「どの分類の失敗か」即座に分類することで対応時間を短縮
- silent skip (PR #419 type) の早期検出
