| name | pr-comment-fixer |
| description | GitHub PRのレビューコメントを自動検出し、コード修正を適用する。インラインスレッド・レビュー本文・Issueコメントに対応し、CodeRabbit・Copilot等のbotコメントも処理する。PRレビュー後の修正作業を自動化したい場合に使用する。Do NOT use for レビュー自体の実施（ai-code-reviewを使用すること）。 |
| metadata | {"version":"2.0.0"} |
PRコメント自動修正スキル
GitHub PRのレビューコメント（CodeRabbit、Copilot等のbotコメント含む）を全APIソースから網羅的に検出し、コード修正を自動適用するスキルです。修正後のpushで生成される新規レビューも追跡し、全コメント対応完了まで修正ループを自動化します。
重要な原則
+---------------------------------------------------------------+
| PRコメント修正の鉄則 |
+---------------------------------------------------------------+
| 1. 3つのAPIソースすべてからコメントを取得する |
| （pulls/comments + pulls/reviews + issues/comments） |
| 2. Review body内のNitpickを見逃さない |
| （CodeRabbitの<details>タグ内等） |
| 3. 推測で修正しない - コメントの指摘内容を正確に理解してから修正 |
| 4. 設計判断が必要なコメントは自動修正せずユーザーに報告 |
| 5. push後は新規レビューの出現を監視してから完了判定 |
| 6. CI全チェックpassを確認してからループ完了 |
+---------------------------------------------------------------+
このスキルを使用する場面
botレビュー指摘の一括対応
- CodeRabbit、Copilot等のbotがPRにレビューコメントを投稿した場合
- 複数のレビュー指摘を効率的に一括修正したい場合
レビュー修正ループの自動化
- 修正→push→botの再レビュー→再修正のサイクルを自動化したい場合
- 手動でのコメント対応が煩雑な場合
修正漏れの防止
- Review body内のNitpickコメント等、見逃しやすいコメントを確実に検出したい場合
- 全種別のコメントを網羅的にチェックしたい場合
基本的な使い方
/pr-comment-fixer {PR番号}
/pr-comment-fixer {PR番号} --max-loops 3
引数
| 引数 | 必須 | デフォルト | 説明 |
|---|
| PR番号 | 必須 | - | 対象のPR番号 |
| --max-loops | 任意 | 5 | 修正ループの最大回数 |
前提条件
gh CLIがインストール済みで認証されていること- 対象リポジトリのクローン内で実行すること
- 対象PRのブランチがチェックアウトされていること
ワークフロー概要
運用ルール: 各フェーズは1応答で1つだけ実行し、結果をユーザーに報告してから次のフェーズへ進む。複数フェーズを1応答で連続実行しない。
PR番号を受け取る
│
├── 1. コメント収集 [comment-collector]
│ → 3 APIソース + GraphQL統合で全未対応コメント一覧を生成
│
├── 2. コメント分類 [comment-classifier]
│ → auto-fixable / manual-required / already-addressed
│
├── 3. 修正適用 [fix-applicator]
│ → auto-fixableコメントを順次修正
│
├── 4. commit & push [commit-manager]
│
├── 5. bot再レビュー待機 & 新規レビュー検出 [loop-controller]
│ │
│ ├── 新規レビュー検出 → Step 1 に戻る
│ └── 新規レビューなし → Step 6 へ
│
├── 6. 完了判定 [completion-evaluator]
│ │
│ ├── 未解決コメント残存 → Step 1 に戻る（maxLoops未到達なら）
│ └── 全条件クリア → 完了
│
└── 7. レポート出力 [report-generator]
→ 修正済み・手動対応要・CI状態を報告
※ [bracket-name] はpr-comment-fixer内部の論理コンポーネント名であり、
個別に呼び出せる独立スキルではない。
論理コンポーネント連鎖:
comment-collector → comment-classifier → fix-applicator
→ commit-manager → loop-controller → completion-evaluator
→ report-generator
各ステップの詳細
Step 1: コメント収集
3つのAPIソースとGraphQLから全コメントを統合的に取得する。
詳細: references/comment_collector_ja.md
収集元
| # | ソース | 取得対象 | 用途 |
|---|
| 1 | GraphQL reviewThreads | 未解決インラインスレッド | isResolved判定 |
| 2 | REST pulls/reviews | レビュー本文（body） | Nitpick等の抽出 |
| 3 | REST pulls/comments | インラインコメント詳細 | path/line/diff_hunk |
| 4 | REST issues/comments | PR全体コメント | Summary等（通常スキップ） |
bot別コメント構造
詳細: references/bot_comment_patterns_ja.md
- CodeRabbit: Actionable → インラインスレッド、Nitpick → Review body内
<details>タグ、Summary → Issueコメント
- Copilot: インラインコメント + suggestion形式
- その他: 汎用パーサーで処理
GitHub APIの構造
詳細: references/github_review_api_ja.md
Step 2: コメント分類
収集したコメントを3つのカテゴリに分類する。
| カテゴリ | 説明 | 対応 |
|---|
auto-fixable | コード修正で対応可能 | 自動修正 |
manual-required | 設計判断が必要、対象ファイル不明等 | ユーザーに報告 |
already-addressed | 既にcommitで修正済み | スキップ |
分類基準:
typeがpraiseまたはsummary → スキップtypeがquestion → manual-requiredpathがnull → manual-required- セキュリティ/アーキテクチャに関する
critical指摘 → manual-required
- それ以外 → auto-fixable
Step 3: 修正適用
詳細: references/fix_applicator_ja.md
auto-fixableコメントを順次修正する:
- 対象ファイルをReadツールで読み込み
- コメントの指摘内容を分析し、該当箇所を特定
- Editツールで修正を適用
- 修正内容を記録
注意事項:
- コメントの指摘に直接対応する最小限の修正のみ
- 周辺コードのリファクタリングは行わない
- suggestion形式（
suggestionコードブロック）は提案コードでそのまま置換
Step 4: commit & push
修正をまとめて1つのコミットにする。
コミットメッセージ:
fix: address PR review comments
Addressed the following review comments:
- [{reviewer}] {path}:{line} - {summary}
...
Step 5: bot再レビュー待機 & 新規レビュー検出
詳細: references/loop_controller_ja.md
push後、botが再レビューを生成するまで待機する:
gh pr checksでCIステータスをポーリング（15秒間隔、最大120秒）pulls/reviewsで新規レビューIDの出現を監視- 全CIがcompletedになり、新規レビューが検出されなくなったら待機完了
新規レビュー検出:
- push前に記録した
known_review_idsと現在のレビューID一覧を比較
- 新規IDがあれば → Step 1に戻る
Step 6: 完了判定
以下のすべてを満たす場合にループ完了:
- GraphQL reviewThreadsで
isResolved: falseのスレッド = 0
- Review body内の未対応コメント = 0
- CIチェックが全てpass
- 新規レビューが検出されていない
Step 7: レポート出力
テンプレート: assets/templates/fix_report_template_ja.md
修正結果を報告する:
- 修正済みコメント一覧（レビュアー、ソース、ファイル、行、対応内容）
- 手動対応が必要なコメント一覧（理由付き）
- CI最終状態
- ループ回数サマリー
制約事項・禁止事項
禁止事項
- 設計判断が必要なコメントを自動修正しない
- コメントの指摘範囲を超えたリファクタリングを行わない
- force pushしない（通常のpushのみ）
- テスト失敗を無視して修正を続行しない（修正が原因の場合）
- Rate Limitを超過するリクエストを行わない
GitHub API Rate Limit対応
- リクエスト間に適切な待機を挟む
gh api rate_limitで残りレートを確認- Rate Limit残量が少ない場合（残り100未満）はユーザーに警告
ベストエフォート修正
自動修正できないコメントがあっても、対応可能なコメントは修正する。修正不可のコメントはレポートに明示し、ユーザーに手動対応を促す。
リソース
