| name | pr-review |
| description | PR についたレビューコメントを取得し、修正・返信・Resolve し、必要なら Copilot に再レビュー依頼して完了までループする。「PR コメント対応して」「レビュー対応」などのリクエストで使用。 |
PR コメント対応スキル（Codex 版）
PR レビューコメント取得、対応、返信、Resolve まで行う。修正を push した場合は Copilot に再レビュー依頼し、Copilot が generated no comments / generated no new comments の review を返すまで繰り返す。
このファイルは Codex 用。待ちは前景同期ブロッキングで行う。スクリプト本体は ~/.claude/skills/pr-review/scripts を指す scripts symlink 経由で Claude 版と共有している。Claude Code 用の待ち手順は ~/.claude/skills/pr-review/SKILL.md を参照。
手順
1. PR と環境を確認
PR 番号と repo はカレントブランチから取得する。指定があればそれを使う。
gh pr view --json number,url,headRefOid,reviewRequests,latestReviews
gh --version
Copilot 再レビュー依頼には gh >= 2.88.0 が必要。
2. Copilot review を待つ
PR 作成直後など、Copilot の初回 review がまだ無い場合がある。コメント取得前に必ず次を実行する。既存の Copilot review があればその結果を使い、まだ無ければ Copilot に review 依頼して待つ。
このスクリプトは Copilot の review が出るまで（最大15分）ポーリングして exit するので、前景で同期実行し、終了するまでそのまま待つ。
python3 ~/.codex/skills/pr-review/scripts/wait-copilot-review.py {owner} {repo} {num}
exit code 0 かつ no_comments: true なら完了。exit code 20 なら Copilot がコメントを生成しているので手順 3 に進む。exit code 1 ならタイムアウトなので状況を確認する。
3. コメント全件取得
python3 ~/.codex/skills/pr-review/scripts/get-review-comments.py {owner} {repo} {num}
gh pr view {num} -R {owner}/{repo} --json reviews --jq '.reviews'
4. 未返信コメントを特定する
in_reply_to_id == null がスレッド起点。起点コメントのうち、自分の返信 (in_reply_to_id == 起点コメント id) がないものを未対応とする。
5. 未対応コメントを分類・対応
- 妥当: コードまたは仕様を修正し、チェック系コマンドを実行する。通ったら具体的なファイルだけ
git add し、git commit --no-gpg-sign -m "..."、必要なら git push する。
- 今対応不要: 設計意図、スコープ外、既知制限など、今対応するべきでない理由を必ず返信する。
- 質問・確認: ユーザーに判断を仰ぐ。
6. 返信
返信本文を /tmp/pr-review-reply.md に書いてから送る。$SHA=$(...) のような代入や command substitution は使わず、必要なら git rev-parse HEAD を単独実行して、その結果を本文に文字列として書く。
python3 ~/.codex/skills/pr-review/scripts/reply-review-comment.py {owner} {repo} {num} {comment_id} /tmp/pr-review-reply.md
7. 返信済みスレッドのみ Resolve
全未解決を一括 Resolve せず、返信済みスレッドだけ Resolve する。
python3 ~/.codex/skills/pr-review/scripts/resolve-review-threads.py {owner} {repo} {num} {comment_id}...
8. push 後に Copilot 再レビュー依頼して待つ
修正を commit / push したら、Copilot に再レビュー依頼して完了まで待つ。手順 2 同様、前景で同期実行し終了するまで待つ。
python3 ~/.codex/skills/pr-review/scripts/wait-copilot-review.py {owner} {repo} {num} --request
exit code 0 かつ no_comments: true なら完了。exit code 20 なら Copilot がコメントを生成しているので手順 3 に戻る。新規コメントを修正、返信、resolve、push し、再度手順 8 を実行する。
注意
- 修正を push した場合は
generated no comments / generated no new comments が返るまで続ける。
- review comment 一覧、review comment への返信、review thread resolve はスキル配下 script を使う。
- Resolve 不可ならユーザーに手動依頼する。
- 「対応不要」判断が難しい場合はユーザーに確認する。
- コミットは適宜分ける。
