pr-feedback-fetch

pr-feedback-fetch

指定された PR について、GitHub の 3 channel (top-level comment / inline review comment / review summary) を順序固定で取得する。出力は 1 つの structured markdown としてまとめる。

gh pr view --comments は top-level comment しか返さないため、inline review comment と review summary を独立に取得する必要がある。本 skill は 3 エンドポイントを不可分に呼び、取得 channel: 3/3 を必ず明示する。

前提

• gh CLI が認証済み (gh auth status で Logged in になっている)
• 現 branch (引数なし時) または引数から PR 番号と repo (owner/repo) を解決できる
• 出力は structured markdown。呼び出し元が workpad / レポート / 判断材料に直接転記できる形

スコープ外

• feedback への返信 / 対応コミット / push。本 skill は「取得して並べる」までで止める
• bot コメント (Actions / dependabot 等) のフィルタ判定。actionable かどうかの判断は呼び出し側に委ねる
• 過去の feedback 履歴の差分管理。常に最新 snapshot を全件取得する
• CI ステータス確認。gh pr checks は別経路で扱う

手順

1. 引数を解決する

呼び出し時の引数は 0 〜 1 個。次のいずれか。

• 引数なし — 現 branch をそのまま対象に gh pr view --json number,url,headRefName,baseRepository で PR 番号を解決する
• 数字 (例 200) — PR 番号として扱う。repo は gh repo view --json nameWithOwner で現 repo を採用する
• URL (例 https://github.com/MH4GF/claude-code/pull/10) — URL から <owner>/<repo> と PR 番号を分解する

引数を解決できない場合 (現 branch の PR が無い等) は即停止し、「PR 未解決」と書いた出力を返す。

2. 3 channel を順に取得する

解決した <owner>/<repo> と <pr> を使い、次の 3 コマンドを順に実行する。順序は固定。途中で止めない。

# 2-1. top-level の PR comment (issue comment と等価)
gh api repos/<owner>/<repo>/issues/<pr>/comments \
  --jq '.[] | {id, user: .user.login, type: .user.type, created_at, updated_at, body}'

# 2-2. inline review comment (diff 上の行コメント)
gh api repos/<owner>/<repo>/pulls/<pr>/comments \
  --jq '.[] | {id, user: .user.login, type: .user.type, path, line, original_line, side, created_at, updated_at, body, in_reply_to_id, pull_request_review_id}'

# 2-3. review summary (Approve / Request changes / Comment レビュー単位)
gh api repos/<owner>/<repo>/pulls/<pr>/reviews \
  --jq '.[] | {id, user: .user.login, type: .user.type, state, submitted_at, body}'

3 channel すべてが空でも 3 コマンドとも実行する。1 つでも省略すると本 skill の意味が失われる。

gh api が失敗した channel は、> ERROR: <message> として出力へ残し、呼び出し側に明示する。残り channel の取得は続行する。