review-response

name	review-response
description	GitHubのレビューコメントを確認して適切に対応 Use when this capability is needed.
metadata	{"author":"178inaba"}

/review-response

GitHubのレビューコメントを確認して適切に対応

使用方法

/review-response            # 全自動：修正＋コメント返信＋解決
/review-response --dry-run  # 確認のみ：指摘点・修正案・コメント案を報告

実行内容

通常モード（引数なし）

1. GitHub GraphQL APIで未解決レビューコメントを取得
2. 各指摘について修正すべきか判断
3. 修正すべき指摘は実装で対応（コミット・プッシュまで）
4. 修正不要な指摘には理由を説明して返信
5. 対応完了後にコメントを解決済みに変更

dry-runモード（--dry-run）

1. GitHub GraphQL APIで未解決レビューコメントを取得
2. 各指摘について修正すべきか判断
3. 指摘ごとに以下を報告：
   • 修正すべきか否かの判断と理由
   • 修正案（コード変更の具体的内容）
   • コメント返信案
4. ユーザーの承認後、修正を実行（コミット・プッシュまで）
   • コメント返信は行わない（案を再提示し、ユーザーが自分で投稿）

判断基準

修正すべき指摘

• 型安全性: any型の使用、型定義の不備
• セキュリティ: 脆弱な実装パターン
• パフォーマンス: 明らかな性能問題
• 保守性: コードの重複、複雑度問題
• バグリスク: 実行時エラーの可能性

修正不要と判断する場合

• 設計思想の違い: 意図的な設計判断
• 既存パターン踏襲: プロジェクト標準に準拠
• nitpick レベル: 好みの問題

GraphQL API 実装

未解決コメント取得

# GraphQL APIで取得後、jqでフィルタリング
gh api graphql --field query='
{
  repository(owner: "OWNER", name: "REPO") {
    pullRequest(number: PR_NUMBER) {
      reviews(first: 50) {
        nodes { author { login } state body }
      }
      reviewThreads(first: 50) {
        nodes {
          id, isResolved
          comments(first: 10) {
            nodes { body, path, line, author { login } }
          }
        }
      }
    }
  }
}' --jq '.data.repository.pullRequest.reviewThreads.nodes[] | select(.isResolved == false)'

スレッドに返信

gh api graphql --field query='
mutation {
  addPullRequestReviewThreadReply(input: {
    pullRequestReviewThreadId: "THREAD_ID"
    body: "返信内容"
  }) {
    comment { id }
  }
}'

スレッド解決

gh api graphql --field query='
mutation {
  resolveReviewThread(input: {
    threadId: "THREAD_ID"
  }) {
    thread { isResolved }
  }
}'

一括返信・解決（推奨）

複数の指摘に同時対応する場合、1リクエストでまとめて実行：

gh api graphql -f query='
mutation {
  r1: addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId: "PRRT_1", body: "修正しました"}) { comment { id } }
  s1: resolveReviewThread(input: {threadId: "PRRT_1"}) { thread { isResolved } }
  r2: addPullRequestReviewThreadReply(input: {pullRequestReviewThreadId: "PRRT_2", body: "修正しました"}) { comment { id } }
  s2: resolveReviewThread(input: {threadId: "PRRT_2"}) { thread { isResolved } }
}'

• エイリアス（r1, s1, r2, s2...）で複数のmutationを1リクエストに結合
• 返信と解決を交互に記述することで、各スレッドの処理が完結

重要な実装ポイント

レビュアー別の解決ポリシー

• Copilot (copilot-pull-request-reviewer): 自動解決
• 人間レビュアー: 未解決のまま（レビュアーの再確認待ち）

修正完了報告フォーマット

<修正内容>を対応しました。
https://github.com/<owner>/<repo>/pull/<PR番号>/commits/<コミットハッシュ>

品質確認

修正後は必ずプロジェクト標準の品質チェックを実行：

• Node.js: npm run lint, npm run typecheck
• Go: go vet, golangci-lint run
• Python: ruff check, mypy

注意事項

• レビュースレッド返信時: pullRequestReviewThreadIdのみ使用（pullRequestReviewIdは不要）
• GraphQLレート制限: 1時間あたり5000ポイント
• 既存PRの自動更新: プッシュでPRは自動更新される

---

Converted and distributed by TomeVault — claim your Tome and manage your conversions.