check-review-backlog

name	check-review-backlog
description	PR 作成直後の review チェック / 全 open PR の未解決 review thread (isResolved=false) を gh api graphql で集計し、 N 日以上未対応のものを backlog として表示する。 `--pr <N>` で単一 PR の review 即時確認 (PR 作成 chain で発動)、 引数なしで全 PR backlog 監視。 `/loop /check-review-backlog` で週次監視に利用可能。 read-only (POST / mutation なし)。 Use when this capability is needed.
metadata	{"author":"ayutaz"}

Unresolved Review Backlog Monitor

全 open PR を走査して、未解決 (isResolved=false) の review thread のうち N 日以上経過しているものを backlog として集計する。レビュー対応漏れの早期警告が目的。

引数

• --pr <N> (任意): 単一 PR の review 即時確認モード。 経過日数フィルタを無視し、 全未解決 thread を表示。 /create-pr skill から PR 作成直後に自動 chain される (例: /check-review-backlog --pr 496)
• --days N (任意): 経過日数の閾値 (デフォルト: 7 日)。 --pr 指定時は無視
• --author <login> (任意): 特定 reviewer (例: copilot-pull-request-reviewer) のコメントに絞る

実行前の確認

• 現在時刻 (UTC): !date -u +"%Y-%m-%dT%H:%M:%SZ"
• 引数: $ARGUMENTS

手順

フェーズ 0: モード判定

$ARGUMENTS を解析:

• --pr <N> を含む: 単一 PR モード (PR 作成直後の auto chain 用)。 フェーズ 1 を skip、 フェーズ 2 を該当 PR 1 件で実行、 フェーズ 3 (日数フィルタ) を skip、 フェーズ 4 で「PR #N の未解決 thread 全件」レポート
• それ以外: backlog 監視モード (週次運用)。 全 open PR を走査

フェーズ 1: Open PR 一覧取得 (backlog モードのみ)

gh pr list --state open --json number,title,createdAt,updatedAt --limit 50

各 open PR について、フェーズ 2 を実行する。

フェーズ 2: 未解決 thread の集計

各 PR について、GraphQL で未解決 review thread + 最初のコメントを取得:

gh api graphql -f query='
query($pr: Int!) {
  repository(owner: "ayutaz", name: "piper-plus") {
    pullRequest(number: $pr) {
      title
      reviewThreads(first: 50) {
        nodes {
          id
          isResolved
          comments(first: 1) {
            nodes {
              databaseId
              path
              line
              body
              createdAt
              author { login }
              url
            }
          }
        }
      }
    }
  }
}' -F pr=<PR_NUMBER> --jq '.data.repository.pullRequest | {
  title,
  unresolved: [.reviewThreads.nodes[] | select(.isResolved == false) | .comments.nodes[0]]
}'

フェーズ 3: 経過日数フィルタリング

各 thread の createdAt (ISO8601) と現在時刻を比較し、days_old >= --days のものを抽出:

# 概念 pseudocode (実際は bash + jq + date で実装)
from datetime import datetime, timezone
now = datetime.now(timezone.utc)
threshold_days = int(args.days or 7)
for thread in unresolved_threads:
    created = datetime.fromisoformat(thread["createdAt"].replace("Z", "+00:00"))
    days_old = (now - created).days
    if days_old >= threshold_days:
        backlog.append({**thread, "days_old": days_old})

--author 指定時は comment.author.login == args.author で更に絞る。

フェーズ 4: 集計レポート

backlog を以下の形式で表示 (経過日数の降順):

## Review Backlog (>= <N> days unresolved)

| PR | Title | Reviewer | path:line | Days | URL |
|----|-------|----------|-----------|------|-----|
| #489 | feat: ... | Copilot | src/foo.py:42 | 21 | https://github.com/.../discussion_r... |
| #501 | fix: ...  | human   | docs/bar.md:10 | 9  | https://github.com/.../discussion_r... |
| ... | ...     | ...     | ...           | ... | ...                                  |

Total: <N> threads across <M> PRs

### 統計
- Copilot bot: <n> threads (<x%>)
- Human reviewers: <n> threads (<x%>)
- 最古: PR #<N>, <days> 日経過

backlog が空の場合: OK: 全 open PR で <N> 日以上未対応の review thread はありません。

フェーズ 5: 推奨アクション

状況	推奨
backlog ≥ 5 件	該当 PR の owner に /reply-review <PR> 実行を促す。Copilot ノイズが多ければ --skip-copilot-style 併用
30 日以上の thread あり	該当 PR の状態を確認 (draft / stale / abandoned)。close / resolve 判断を促す
Copilot bot 比率 ≥ 60%	/reply-review <PR> --skip-copilot-style を案内
単一 PR で 10+ unresolved	その PR の review 状況が悪化中。優先対応

継続監視モード

/loop /check-review-backlog          # 自動 pace (週次目安)
/loop 24h /check-review-backlog      # 24 時間ごと
/loop /check-review-backlog --days 3  # 3 日閾値で監視

使用例

# 7 日以上未対応の thread を一覧 (デフォルト)
/check-review-backlog

# 3 日以上に閾値を厳しく
/check-review-backlog --days 3

# Copilot コメントのみ
/check-review-backlog --author copilot-pull-request-reviewer

# 週次監視
/loop /check-review-backlog

注意事項

• read-only: 本 skill は POST/mutation を一切行わない。集計と表示のみ
• rate limit: 50 open PR × GraphQL query で ~50 req、GitHub API 制限 (5000/h) 内
• タイムゾーン: createdAt は UTC。日数計算は UTC 基準
• fork PR: 外部 contributor の fork PR も含む
• draft PR: 集計対象 (draft でも review コメントが付くため)
• 集計結果は scrollable な table で、ユーザが目視で優先度判定する想定

期待効果

• レビュー対応漏れの可視化 (memory feedback_copilot_stale_review の延長線上)
• /reply-review 実行のトリガとして利用 (どの PR を優先対応すべきか判断材料)
• 長期 unresolved の発見 → PR の active/abandoned 判定を促進

---

Source: ayutaz/piper-plus — distributed by TomeVault.