--- name: w-revise description: | PRのレビュー指摘を分析し修正を適用します。 Use after creating a PR to self-review and improve it before merge — reviewers (w-tech-advisor / w-e2e-planner / w-implementer) review via Agent single spawns by specialty, w-implementer applies fixes. Triggers: "review the PR", "address review comments". Only for your own team's PR — not for reviewing other teams' PRs. when_to_use: "PR のレビュー指摘に対応したい、マージ前に PR を見直して直したい" --- # レビュー対応 自 PR をレビュアー 3 体に見てもらい、指摘を PR に投稿する。ユーザーに採否を一括で確認し、採用分だけ直してコミットする。最後に対応報告を投稿する。 ## 手順 ### Step 1: PR 情報を取得 対象 PR の本文・diff・既存レビューを読む。引数が無ければ、会話から一意に決まる PR を使う。決まらなければユーザーに聞く。 `pr_read` を `pr_ref: "//"`・`reviews: true` で呼ぶ。 紐づいた Issue があれば、それも読む。`issue_read` を `issue_ref: "//"` で呼ぶ。 ### Step 2: 各レビュアーに専門視点でレビューを依頼 Step 1 の情報を渡し、3 体に diff をレビューさせる。各レビュアーは `Agent` ツールの単発 spawn で起動する。追質問は `SendMessage` で送る。 - 3 体の並列 spawn を既定とする。直列にする場合のみ、理由を `w-tech-advisor` の Goal(spawn prompt の冒頭行)末尾に括弧書きで添える(例: `(直列の理由: ...)`) - 1 メッセージ内の複数 `Agent` 呼び出しで spawn する。別メッセージで順に spawn すると直列になる。 | エージェント種別 | レビュー視点 | |---|---| | w-tech-advisor | 技術的正確性(API使用法、アーキテクチャ、ライブラリ利用、非推奨パターン) | | w-e2e-planner | CUJ観点・テスト品質(妥当性、網羅性、変更がCUJに与える影響、追加すべきCUJ、実CUJ実行による動作確認) | | w-implementer | コード品質(バグ、エラーハンドリング、重複、可読性) | Resolved 済みの既存スレッドは対象に含めない。 ### Step 3: 指摘を採番し、インラインコメントと `review-findings` に振り分けて投稿 レビュアーの指摘と既存の外部レビューコメントをまとめ、`F-01` から連番を振る。 投稿先は次のとおり。外部レビュアーの指摘は投稿し直さず、`review-findings` の Disposition に元スレッドの URL を添えて並べるだけにする。 | 指摘 | 投稿先 | |---|---| | diff のハンク内の行を指せる | インラインコメント | | ファイル単位でしか言えない | ファイルコメント | | それ以外(PR 本文・欠落・diff 外・横断的な設計) | `review-findings` の General 節 | インラインコメントの本文は `**F-NN**` で始める。`<...>` のプレースホルダ・チェックボックス記法を書かず、型や比較の記法はバッククォートで囲む。 #### ホストと head sha `gh` には対象 PR のホストを `--hostname` で必ず渡す。cwd の origin から求めるので、対象リポのワークツリーで打つ。空なら止める。未認証なら `gh auth login -h ` を案内して止める。 ```bash GH_HOST=$(git remote get-url origin | sed -E 's#^[a-z0-9+.-]+://##; s#^[^@/]*@##; s#[:/].*$##') [ -n "$GH_HOST" ] || { echo "origin からホストを導出できない" >&2; exit 1; } gh auth status -h "$GH_HOST" ``` 以降のコマンドには、得たホスト名を直接書く。head sha は API から取る。 ```bash gh api --hostname <対象ホスト> repos///pulls/ --jq .head.sha ``` #### インラインコメント 1 つの review にまとめて投稿する。`event` は `COMMENT` にする。インライン対象が 0 件なら投稿しない。本文の改行は `\n` にする。 ```bash gh api --hostname <対象ホスト> \ repos///pulls//reviews \ --input - <<'JSON' { "commit_id": "", "event": "COMMENT", "comments": [ {"path": "cli/core/sections.py", "line": 42, "side": "RIGHT", "body": "**F-01** 指摘内容"} ] } JSON ``` 422 で拒否されたら、疑わしい 1 件を外して再送し、原因の F-NN を General 節へ回す。 ファイルコメントと、スレッドへの返信は 1 件ずつ投稿する。 ```bash gh api --hostname <対象ホスト> \ repos///pulls//comments \ --input - <<'JSON' {"commit_id": "", "path": "cli/core/sections.py", "subject_type": "file", "body": "**F-02** 指摘内容"} JSON ``` ```bash gh api --hostname <対象ホスト> \ repos///pulls//comments \ --input - <<'JSON' {"in_reply_to": 1234567, "body": "返信本文"} JSON ``` `in_reply_to` は、返信先スレッドの先頭コメントの `databaseId`(数値)にする。 #### F-NN とスレッド ID の対応表 次のクエリで、先頭コメントの `**F-NN**` からスレッドの `id` と `url` を引き、Step 6 まで保持する。 ```bash gh api --hostname <対象ホスト> graphql \ -f query=' query($owner: String!, $repo: String!, $number: Int!) { repository(owner: $owner, name: $repo) { pullRequest(number: $number) { reviewThreads(first: 100) { nodes { id isResolved isOutdated comments(first: 1) { nodes { databaseId body url } } } } } } }' \ -f owner= -f repo= -F number= ``` #### `review-findings` を投稿 テンプレを取り、ガイドに従って書いて、修正の前に投稿する。General にはインラインにできなかった指摘だけを書く。Disposition には全 F-NN を 1 行ずつ並べ、コメントの URL を添える。 1. `issue_comment` を `prepare: true`・`template: "review-findings"`・`issue: "//"` で呼ぶ 2. 書いたら、`issue_comment` を `file: "<書いたファイル>"` で呼ぶ ### Step 4: 対応可否をユーザーに一括確認 Step 3 のコメントの URL を示し、AskUserQuestion で次の 3 択(と Other)を出す。指摘ごとには聞かない。 | label | description | |---|---| | すべて対応 | F-01 から F-NN まで全件を w-implementer に渡して修正 | | 一部のみ対応 | Other 自由入力で採用する F-NN をカンマ区切り指定(例: `F-01, F-03`) | | 対応なし | すべての指摘を「ユーザー判断で対応不要」として report に記録 | 指摘が 0 件なら、Step 3 と Step 6 のコメントを 0 件の文言で投稿し、Step 4・5 と resolve を飛ばす。 ### Step 5: 採用分を w-implementer に分けて並列で修正し、main がコミット まず、選択に関わらず次の 2 つを行う。 1. `review-resolution` のテンプレを取り、Decision 節と Declined 節を埋める。`issue_comment` を `prepare: true`・`template: "review-resolution"`・`issue: "//"` で呼ぶ。 2. 対応不要の F-NN のスレッドに、理由を返信する(Step 3 の `in_reply_to`)。 「対応なし」ならここで Step 6 へ進む。採用分があれば、次のとおり直す。 - 複数 w-implementer の並列起動を既定とする。直列にする場合のみ、理由を `w-implementer-1` の Goal 末尾に括弧書きで添える(例: `(直列の理由: ...)`) - 採用した F-NN をファイル群で分け、1 群に 1 体を割り当てる。同じファイルを 2 体に渡さない。ファイルに紐づかない F-NN は main が直す - spawn の前に、割り当て表(実装者名 / 担当 F-NN / 担当ファイル群)をチャットに書く - 1 メッセージ内の複数 `Agent` 呼び出しで spawn する。別メッセージで順に spawn すると直列になる。 - 全員の結果がそろったら、main が 1 コミットにまとめる。コミットメッセージに対応した F-NN を書く 採用した指摘は、この PR の中で直しきる。後の PR に回さない。 ### Step 6: CUJ 再実行・インラインスレッドの一括 resolve・`review-resolution` の投稿 #### CUJ 再実行 Step 2 で w-e2e-planner が実行した CUJ が、直したファイルを読むなら、w-e2e-planner を単発 spawn して再実行させる。prompt には CUJ の 3 要素(誰が・起点・合格基準)と修正の要約を貼る。実投稿を含む CUJ は main が実行する。不合格なら Step 5 の修正に戻る。 #### スレッドを一括 resolve 対応表のクエリを引き直し、次をすべて満たすスレッドを、採用分・対応不要分とも 1 リクエストで resolve する。 - 先頭コメントが `^\*\*(R\d+/)?F-\d+` に一致する - `isResolved` が false - 今回の対応表に載っている alias は F-NN 順に `t1` から振り、スレッド ID はそのまま書く。 ```bash gh api --hostname <対象ホスト> graphql -f query=' mutation { t1: resolveReviewThread(input: {threadId: ""}) { thread { id isResolved } } t2: resolveReviewThread(input: {threadId: ""}) { thread { id isResolved } } }' \ | jq -r 'if .data then (.data | to_entries[] | "\(.key) \(.value.thread.isResolved // "FAILED")") else "REQUEST FAILED: \(.errors // . | tostring)" end' ``` `FAILED` の alias だけを再送する。出力の行数が対象スレッド数と一致することを確かめる。 #### `review-resolution` を投稿 Step 5 で書き始めたファイルを、テンプレのガイドに従って仕上げて投稿する。コミットの sha と、コミットメッセージにある対応内容は本文に書かない。`issue_comment` を `file: "<書いたファイル>"` で呼ぶ。 チャットには `review-resolution` の本文をそのまま示す。マージが必要なら `/pecot-w:w-merge` を案内する。 ## 注意 - 採否は Step 4 のユーザーの判断で決める。指摘を盲目的に適用しない。 - 返信と resolve は、w-revise が開いたスレッドに限る。 - 2 巡目以降は F-NN を `F-01` から振り直し、本文は `**R2/F-01**` の形で始める。前のラウンドで開いた未解決スレッドと同じ趣旨の指摘は、新しく投稿せずそのスレッドに返信する。