piper-plus: Skill for Claude Code

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,bucket,link,workflow --jq '.[]'

gh pr checks --json に conclusion フィールドはない (指定すると Unknown JSON field エラー)。 使えるフィールドは bucket / completedAt / description / event / link / name / startedAt / state / workflow (gh pr checks --help の JSON FIELDS)。 集計は bucket で行う:

• bucket: pass / fail / pending / skipping / cancel (state を gh が 5 分類したもの)
• state (詳細表示用): SUCCESS / FAILURE / PENDING / SKIPPED / NEUTRAL / CANCELLED 等。 例: NEUTRAL と SKIPPED はどちらも bucket skipping

pending があると gh pr checks は exit code 8 で終わる (失敗ではない)。

フェーズ 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 (bucket pending ≥ 1): 「N checks がまだ走行中、再度 polling を推奨」
• Suspicious skip (cancelled+skipped が 3 件以上連続): silent skip の可能性を警告 (PR #419 事例)

フェーズ 4: 失敗 job の分析 (failure ≥ 1 時のみ)

各失敗 job について:

1. job 名と link を表示
2. gh run view <run-id> --log-failed で失敗 step のログを fetch (最大 100 行)
3. ログを以下の 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 を案内
4. 分類別に推奨アクションを提示