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-required
• pathがnull → manual-required
• セキュリティ/アーキテクチャに関するcritical指摘 → manual-required
• それ以外 → auto-fixable

Step 3: 修正適用

詳細: references/fix_applicator_ja.md

auto-fixableコメントを順次修正する:

1. 対象ファイルをReadツールで読み込み
2. コメントの指摘内容を分析し、該当箇所を特定
3. Editツールで修正を適用
4. 修正内容を記録

注意事項:

• コメントの指摘に直接対応する最小限の修正のみ
• 周辺コードのリファクタリングは行わない
• 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が再レビューを生成するまで待機する:

1. gh pr checksでCIステータスをポーリング（15秒間隔、最大120秒）
2. pulls/reviewsで新規レビューIDの出現を監視
3. 全CIがcompletedになり、新規レビューが検出されなくなったら待機完了

新規レビュー検出:

• push前に記録したknown_review_idsと現在のレビューID一覧を比較
• 新規IDがあれば → Step 1に戻る

Step 6: 完了判定

以下のすべてを満たす場合にループ完了:

1. GraphQL reviewThreadsでisResolved: falseのスレッド = 0
2. Review body内の未対応コメント = 0
3. CIチェックが全てpass
4. 新規レビューが検出されていない

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未満）はユーザーに警告

ベストエフォート修正

自動修正できないコメントがあっても、対応可能なコメントは修正する。修正不可のコメントはレポートに明示し、ユーザーに手動対応を促す。

リソース

ファイル	説明
references/github_review_api_ja.md	GitHub Review API構造の解説
references/bot_comment_patterns_ja.md	各botのコメントパターン一覧
references/comment_collector_ja.md	コメント収集ロジック詳細
references/fix_applicator_ja.md	修正適用ロジック詳細
references/loop_controller_ja.md	ループ制御ロジック詳細
assets/templates/fix_report_template_ja.md	修正結果レポートテンプレート