validate-review

レビューコメントの妥当性検証

GitHub PR のレビューコメントを取得し、対象コードを確認して指摘の妥当性を判断します。 この Skill は GitHub への書き込み（返信・投稿）を一切行いません。 返信は確認後に /eccube-dev-agents:reply-review でまとめて投稿します。

引数パターン

$ARGUMENTS に応じて対象を決定する:

パターン	引数	対象
A	なし	現在ブランチの PR のレビューコメントすべて
B	PR URL (.../pull/{n}) または PR 番号	その PR のレビューコメントすべて
C	レビューコメント URL (.../pull/{n}#discussion_r{id})	指定された 1 件のみ

判定は URL に #discussion_r が含まれるかで行う。含まれない場合は「コメント指定なし」= 全件検証。

1. 対象 PR の特定

パターン A（引数なし）

gh pr view --json number,url,title,headRefName,baseRefName,state
gh repo view --json nameWithOwner

• 現在ブランチに紐づく PR が存在しない場合は、その旨を報告して終了（勝手に PR を作成しない）
• 複数リポジトリ構成の場合は先に pwd と git remote -v で対象リポジトリを確認する

パターン B / C（URL または PR 番号）

• URL から owner, repo, pr_number, （あれば）comment_id を正規表現で抽出
• PR 番号のみが渡された場合は gh repo view --json nameWithOwner で owner/repo を補完

2. レビューコメントの取得

パターン A / B（全件）

レビュースレッド単位で取得し、解決状態と返信状況を把握する:

gh api graphql -f query='
query($owner:String!, $repo:String!, $pr:Int!) {
  repository(owner:$owner, name:$repo) {
    pullRequest(number:$pr) {
      reviewThreads(first:100) {
        nodes {
          isResolved
          isOutdated
          path
          line
          comments(first:50) {
            nodes { databaseId url author { login } body createdAt }
          }
        }
      }
    }
  }
}' -f owner={owner} -f repo={repo} -F pr={pr_number}

コメント本文が長く切り詰められる場合や diff_hunk が必要な場合は、REST でも取得する:

gh api repos/{owner}/{repo}/pulls/{pr_number}/comments --paginate

検証対象の切り分け（すべて一覧に載せ、スキップしたものも理由を明記する）:

• 検証する: 未解決（isResolved: false）のスレッドの先頭コメント
• スキップ: isResolved: true のスレッド（解決済み）
• スキップ: 投稿者が PR 作成者自身のコメント（自分の返信）
• 文脈として読むのみ: スレッド内の 2 件目以降の返信（既に議論済みの内容を再指摘しない）
• isOutdated: true のスレッドは「該当コードが変更済み」の可能性があるため、現行コードとの差異を判定理由に明記する

パターン C（単一）

gh api repos/{owner}/{repo}/pulls/comments/{comment_id}

いずれの場合も以下を抽出:

• body: コメント本文（指摘内容）
• path: 対象ファイルパス
• diff_hunk: 対象コードの差分
• line / original_line: 行番号
• commit_id: コメント対象のコミット SHA
• user.login / author.login: コメント投稿者
• html_url: コメント URL（報告と reply-review での参照に使う）