address-pr-comments

PR コメントハンドラー

現在のブランチのオープンな PR を見つけ、gh CLI を使ってコメントに対応するためのガイドです。すべての gh コマンドは、ネットワークアクセスを昇格させて実行してください。

事前確認

1. 以下の手順をまとめたタスクリストを作成します
2. 実施内容をユーザーに伝えます

問題が発生した場合や、最善の進め方が不明な場合を除き、このワークフロー全体を自律的に実行するよう努めてください。

ステップ 1：対応が必要なコメントを確認する

• <path-to-skill>/scripts/fetch_comments.py を実行します。このスクリプトは、PR 上のすべてのコメントとレビューのスレッドを出力します

ステップ 2：コメントとレビューのスレッドで特定された問題を列挙する

• すべてのレビューのスレッドとコメントに番号を付けます
• レビュアーからの修正案も含め、各「問題候補」の概要を簡潔に記載します

ステップ 3：対応可能な問題を特定する

• 各問題候補について、コードベースと照らし合わせて分析し、対応が必要な項目と、誤検出またはコード変更を必要としないコメント（質問、提案、スタイルに関するコメントなど）を区別します。
• 現在のコードで各指摘を検証します。現在も有効な問題のみを修正し、その他は簡潔な理由を添えてスキップします。変更は最小限に抑え、検証を行います。

ステップ 4：対応可能なすべての問題を修正し、コメントに対応する

• 可能な場合は TDD を使用します。問題を再現する失敗するテストを書いてから、テストが通るように修正します。
• GitHub の UI で対応と並行してスレッドを解決するか、返信します。対応しないコメントについては、理由を添えてレビュアーに返信し、必要に応じて説明を求めます。

ステップ 5：チェックを実行し、変更をコミットしてプッシュする

• 修正後、関連するテストとチェックをローカルで実行し、問題が解決したことを確認します。
• 行った変更を要約し、PR と問題番号を明記したわかりやすいメッセージでコミットし、PR ブランチにプッシュします。

ステップ 6：CI Actions を監視し、新たな失敗に対応する

• プッシュ後、PR の CI チェックを監視し、変更によって新たな失敗が発生していないか確認します。
• 新たな失敗が発生した場合は、gh-fix-ci スキルを使って CI ログを分析し、根本原因を特定して必要な修正を行います。

最終確認と概要

• GitHub の UI ですべてのコメントに対応し、解決済みになっていることを再確認します。
• コメント対応プロセスの結果を要約し、未解決の質問やレビュアーとのフォローアップが必要な事項があれば含めます。

注意事項：

• 実行中に gh で認証やレート制限の問題が発生した場合は、ユーザーに gh auth login で再認証するよう依頼してから、再試行します。
• サンドボックスによって gh auth status がブロックされた場合は、sandbox_permissions=require_escalated を指定して再実行します。