| name | shiiman-github:pr-review-check |
| description | 自分の PR に付いたレビューコメントを確認し、修正対応を実行する(PR作成者向け)。「レビュー対応」「レビューコメント確認」「指摘を修正」「PRコメント確認」などで起動。「修正して」と伝えれば指摘の修正まで実行する。 |
| allowed-tools | ["Read","Write","Edit","Bash","Glob","Grep","AskUserQuestion"] |
| argument-hint | [PR番号] |
| context | fork |
| agent | shiiman-github:reviewer |
Check PR Review
自分の PR に付いたレビューコメントを確認し、修正対応を実行します。
注意: 他者の PR をレビューする場合は pr-review を使用してください。
Help
$ARGUMENTS に --help が含まれる場合、以下を表示して終了:
/shiiman-github:pr-review-check - レビュー指摘対応(PR 作成者向け)
概要:
自分の PR に付いたレビューコメントを確認し、修正対応を実行する。
既定は確認のみ。「修正して」と伝えると修正まで実行する。
使用方法:
/shiiman-github:pr-review-check [PR番号]
オプション:
--help このヘルプを表示
実行モードの伝え方(フラグの代わり):
指定なし → レビュー指摘の確認のみ(修正・投稿はしない)
「修正して」「対応して」 → 指摘の修正・コミット・プッシュ・返信投稿まで実行
例:
/shiiman-github:pr-review-check # 現在のブランチの PR のレビューを確認
/shiiman-github:pr-review-check 123 # PR #123 のレビューを確認
「レビュー指摘を修正して」 # 指摘を修正して対応
起動時の自動判断(フラグの代わり)
引数・発話から実行モードを判定する。明示がなければ「確認のみ」とする(安全側)。
| モード | 条件 | 動作 |
|---|
| 確認のみ | 既定 | 指摘事項を分類して表示するだけ。修正・投稿はしない |
| 修正 | 「修正して」「対応して」等の発話 | 指摘を修正 → 確認 → コミット・プッシュ・返信投稿 |
修正モードでは、コミット・プッシュ・返信投稿(外部・不可逆)の前に必ずユーザー確認を取る。
ワークフロー
ステップ 1: PR 番号の特定
PR 番号が指定されていない場合、現在のブランチの PR を検出:
gh pr view --json number,title,url
ステップ 2: レビューコメントの取得
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments
gh pr view {pr番号} --json reviews
ステップ 3: 指摘事項の分類と表示
| プレフィックス | 種別 | 対応 |
|---|
| must. | 修正必須 | 必ず修正して返信 |
| imo. | 改善提案 | 基本的に修正して返信 |
| nits. | 軽微 | 修正して返信 |
| q. | 質問 | 返信で回答 |
表示形式:
=== PR #{pr番号}: {タイトル} ===
【must.】修正必須 (N件)
1. [{ファイル}:{行}] {コメント内容}
comment_id: {id}
【imo.】改善提案 (N件)
...
「修正して」と伝えると、指摘の修正まで実行できます。
確認のみモード(既定)の場合はここで終了する。
ステップ 4: 修正の実行(修正モードと判定した場合)
各指摘事項について:
- 対象ファイルを Read で読み込む
- 指摘内容を理解して修正方針を決定
- Edit で修正を実行
- 修正内容を記録(返信用)
ステップ 5: コミット・プッシュ(外部・不可逆 → 確認必須)
コミット・プッシュ・返信投稿は取り消しにくい外部操作のため、実行前に AskUserQuestion で必ず確認する。
question: "修正内容をコミット・プッシュし、各レビューコメントに返信しますか?"
options:
- 実行する: コミット → プッシュ → 返信投稿まで行う
- 修正のみ: 変更は残すが、コミット・プッシュ・投稿はしない
- 中止する: 何もしない
「実行する」を選択した場合のみ以下を実行する。
git add .
git commit -m "fix: レビュー指摘を修正"
git push
ステップ 6: レビューコメントへの返信(重要)
修正を実行したら必ず各コメントに返信を投稿する。
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments/{comment_id}/replies \
-X POST \
-f body="修正しました。{修正内容の説明}"
返信メッセージのテンプレート:
| 対応種別 | 返信メッセージ |
|---|
| コード修正 | 修正しました。{具体的な修正内容} |
| 提案採用 | ご提案ありがとうございます。採用しました。 |
| 質問への回答 | {質問への回答} |
| 対応見送り | ご指摘ありがとうございます。{理由} のため、今回は見送りとさせてください。 |
ステップ 7: 結果報告
## レビュー指摘への対応を完了しました
### 修正内容
| 指摘 | ファイル | 対応 | 返信 |
|------|----------|------|------|
| must. {内容} | {file}:{line} | ✅ 修正済み | ✅ 返信済み |
| imo. {内容} | {file}:{line} | ✅ 修正済み | ✅ 返信済み |
### コミット
- ハッシュ: {commit_hash}
- プッシュ: ✅
再レビューをお願いしてください。
返信 API の詳細
コメントへの返信
gh api repos/{owner}/{repo}/pulls/{pr番号}/comments/{comment_id}/replies \
-X POST \
-f body="修正しました。"
レビュー全体への返信(オプション)
gh pr comment {pr番号} --body "レビューありがとうございます。全ての指摘に対応しました。"
重要な注意事項
- ✅ 修正したら必ずコメントに返信する
- ✅ 返信には具体的な修正内容を記載する
- ✅ 質問には丁寧に回答する
- ✅ 対応見送りの場合も理由を説明する
- ❌ 指摘を無視しない
- ❌ 返信せずにプッシュだけしない