address-pr-feedback

PR フィードバックへの対応

既存の PR フィードバックを確認し、修正、検証、プッシュ、レビュアー向けの返信まで対応します。Git と認証済みの gh が必要です。任意の収集スクリプトには Python 3 も必要です。PR フィードバックには、レビュー本文、イシューコメント、ボットによる要約、差分外の指摘、インラインスレッド、フォローアップが含まれます。

依存関係のある PR の場合は、チェーンをマッピングまたは変更する前にスタックされた PRを読んでください。フィードバックへの対応だけでは、ターゲットの変更、履歴の書き換え、マージは許可されません。許可されている場合に限り、ランディングの手順を使用してください。

収集と評価

リポジトリ、PR、ベースとヘッド、作成者、最新のヘッド SHA、レビュー状態を特定します。PR が指定されていない場合は、gh pr view で現在のブランチの PR を推定します。

フィードバックとリアクションを漏れなく収集するには、scripts/collect_pr_feedback.py の使用を推奨します。

python3 <skill-dir>/scripts/collect_pr_feedback.py <pr-url-or-number>

Markdown レポートを読み、ID、返信構造、スレッドのメタデータには JSON を使用します。利用できない場合は、gh を使って PR 本文とリアクション、イシューコメントとリアクション、レビュー、インラインコメントと返信、コミット、ファイル、利用可能なスレッド解決状態を同等に収集します。リアクションしたユーザーの識別情報も含めます。Potential Outside-Diff Sources と、対応可能な指摘や細かな指摘、または Prompt for all review comments の各セクションを確認してください。キーワード検出だけで、フィードバック全体を読む代わりにはなりません。

評価や編集の前に、以下のアクティブレビューゲートを適用します。次に、対応可能な項目の簡潔な台帳を作成し、参照元のリンク／ID、影響を受けるコード、状態、対応内容、返信先を記録します。スレッドを特定できない指摘も含め、重複をまとめる場合はすべての参照元リンクを残します。提案は現在のコードと PR の意図に照らして検証し、古くなっている、すでに修正済み、誤っている、または有害な提案は、むやみに適用せず根拠を示して記録します。

アクティブレビューゲート

手動での Codex と CodeRabbit のレビュー依頼は、PR 単位で一度だけ行うものであり、プッシュのたびに必要なものではありません。段階的な追加プッシュで再依頼しないでください。どちらのサービスもアクティブでなければ、既存のフィードバックを使用し、存在しないレビューを要求しないでください。自動的に開始されるレビューには対応します。

必要に応じて、新しいリアクション、トリガー／ステータスコメント、レビュー、要約、チェックを確認し、証拠を現在のヘッドと照合して状態を分類します。

• Codex のリアクション状態を確認できるのは、chatgpt-codex-connector[bot] または確認済みの代替ユーザーだけです。集計された件数や他のユーザーは対象になりません。
• PR 本文への Codex の eyes リアクション、または @codex review コメントは、依頼の受理または処理中を意味します。Codex の +1 は、レビュー本文がなくても、指摘なしで完了したことを意味します。対象、ユーザー、タイムスタンプを記録してください。指摘を含む Codex 作成のレビューも、完了した証拠になります。
• CodeRabbit の処理中／ステータスメッセージは処理中を意味します。完了したレビューまたは最終要約は完了の証拠になります。

観測されたアクティブレビューがすべて完了するまで待ち、評価、台帳の作成、チェックアウト、編集、プッシュ、返信の前にフィードバックを再取得します。アクティブなシグナルがあれば、その依頼は受理済みです。再度トリガーしないでください。明示的な失敗、または妥当な待機時間を超えて停滞しているレビューを診断し、フィードバックの受付がブロックされていることを報告します。

修正と公開

gh pr checkout <pr-url-or-number> またはリポジトリのワークフローを使って PR ブランチをチェックアウトします。無関係な作業を保持し、フェッチしてから、編集前に新しいリモートコミットを取り込みます。ヘッドが変わった場合は、影響を受けるフィードバックを再評価します。

フィードバックへの対応内容に対応するコミットを作成し、まとまりのあるグループごとに修正します。対象範囲と委任された判断権限に応じて、限定的な修正か必要なリファクタリングかを選びます。未解決の重要な設計判断を解決します。対象を絞った検証と必要な検証を実行し、追加差分についてローカルで実装レビューを一度行って、対応可能な指摘を修正します。

検証後にプッシュします。長時間のタスクでリモートからの確認が必要な場合は、区切りのよい作業グループが完了した時点でプッシュします。各プッシュ後にフィードバックを再取得し、Codex または CodeRabbit が新たなレビューを開始した場合は、アクティブレビューゲートに戻ります。

返信して完了する

該当するコミットをプッシュしてから返信します。インラインの指摘にはレビューコメント返信エンドポイントを使用し、返信文はファイルに保存しておきます。

gh api -X POST repos/OWNER/REPO/pulls/PR_NUMBER/comments/COMMENT_ID/replies -F body=@/path/to/reply.md

レビュー本文、PR レベル、ボットの要約、スレッドのない差分外の指摘には、対応した項目を投稿元ごとにまとめ、プッシュしたコミット、検証結果、提案をスキップまたは却下した理由を記載した簡潔な PR コメントを 1 件投稿します。PR の担当者として、具体的にコードに基づく返信を行い、ローカルのスキルや自動化に関する詳細は省きます。

すべての対応可能な項目を修正して返信するか、根拠を添えて明示的にスキップするか、未解決のユーザー判断事項として特定し、すべての追加コミットをプッシュし、返信に検証結果とレビューの根拠を記録したら完了です。Codex または CodeRabbit のレビューがアクティブなまま残っていてはなりません。また、最新のレビュー完了後にフィードバックを再取得している必要があります。スタックの場合は、選択したスコープの完了を宣言する前に、選択した PR をすべて対応します。

プッシュしたコミット、検証結果、未解決のフィードバック、または具体的なブロッカーを報告します。レビューがブロックされている場合やプッシュが未完了の場合、フィードバック対応が完了したとは見なしません。