pr-threads-address

前提条件

gh pr-review 拡張機能

このコマンドを使用する前に、gh pr-review 拡張機能がインストールされているか確認します。

gh extension list | grep -q pr-review || gh extension install agynio/gh-pr-review

PR コンテキストの特定

すべての gh pr-review サブコマンドには、--pr <number> と --repo <owner/repo> の両方が必要です。どちらも省略しないでください。ワークフローの開始時に値を一度だけ調べ、その後のすべてのコマンドにリテラルの番号とスラッグを指定します。

現在のブランチの PR 番号を取得します。

gh pr view --json number -q .number

リポジトリのスラッグを取得します。

gh repo view --json nameWithOwner -q .nameWithOwner

続いて、結果の値をそのまま指定します。たとえば、このワークフローで後続の gh pr-review を呼び出すたび（レビューの表示、コメントへの返信、スレッドの解決など）に、--pr 42 --repo posit-dev/skills のように指定します。

ワークフロー

1. 未解決の PR レビュースレッドをすべて取得して表示します
2. 各スレッドを分析し、要求されている変更を把握します
3. 各スレッドについて、次の手順を行います。
   1. 必要なコード変更を行います
   2. （可能な場合）変更を検証する単体テストを追加します
   3. Conventional Commits の仕様に従って、内容がわかるコミットメッセージで変更をコミットします
4. 対応したスレッドの概要を報告します
5. スレッドを解決するかユーザーに確認します。解決する場合は、実施した内容を各スレッドに返信してからスレッドを解決します。

CLI リファレンス

PR レビューとコメントの表示

プルリクエストのレビュー、インラインコメント、返信をすべて表示します。

gh pr-review review view --pr <number> --repo <owner/repo>

一般的なフィルター：

• --reviewer <login> — 指定したレビュアーで絞り込みます
• --states <list> — カンマ区切りのレビュー状態（APPROVED、CHANGES_REQUESTED、COMMENTED、DISMISSED）で絞り込みます
• --unresolved — 未解決のスレッドのみを表示します
• --tail <n> — スレッドごとに最後の n 件の返信のみを表示します
• --include-comment-node-id — 返信の GraphQL ノード ID を含めます

レビュースレッドへの返信

gh pr-review comments reply --thread-id <PRRT_...> --body "<reply-text>" --repo <owner/repo> --pr <number>

複数行の返信には、ヒアドキュメント構文 --body "$(cat <<'EOF' ... EOF\n)" を指定します。

スレッドの解決

gh pr-review threads resolve --thread-id <PRRT_...> --pr <number> --repo <owner/repo>

スレッド ID（形式は PRRT_...）は、review view --include-comment-node-id から取得します。