| name | pr-comment |
| description | PRの特定レビューコメント(discussion)への対応。使用タイミング: (1) PR URLに#discussion_r<id>を添えて「この指摘に対応して」と依頼された時、(2) PR番号+特定の指摘内容を示して対応を依頼された時。境界: PR全体のレビュー→pr-review、レビュー返信文の作成のみ→ukwhatn-writing。 |
pr-comment - PRレビューコメント対応
PRに付いた特定のレビューコメント(discussion)を取得し、指摘への対応(実装修正)と返信ドラフト作成までを一括で行う。
既存設定との関係
- pr-reviewスキル: PR全体のレビュー用。本スキルは個別コメントへの対応用
- commitスキル: 対応コミットは/commit準拠(git-cz形式)
- ukwhatn-writingスキル: 返信ドラフトの文体はこれに従う
- worktree運用(user-level AGENTS.md): コード修正を伴うためworktree運用ルールに従う
ワークフロー
1. アカウント確認(EMU誤アカウント防止)
gh auth status
EMU等で複数アカウントを使い分けている場合は、PJ CLAUDE.mdの指定に従い gh auth switch で切り替える。
2. コメントの取得
URLから owner/repo、PR番号、comment ID(#discussion_r<id> の数値部分)を抽出:
gh api repos/<owner>/<repo>/pulls/comments/<id>
gh api repos/<owner>/<repo>/pulls/<number>/comments --paginate | jq '[.[] | select(.id == <id> or .in_reply_to_id == <id>)]'
comment IDが不明(「◯◯という指摘」等の口頭指定)の場合は、PR全コメントから該当コメントを検索し、複数候補があればユーザーに確認する。
3. PR headの特定とcheckout/worktree判断
現在のブランチに直接修正しないこと。
gh pr view <number> --json headRefName,headRefOid,baseRefName
- 修正を伴う場合: PR headブランチをPJのworktree手段でcheckout(PJ CLAUDE.mdに定義された手段を使用)
- 対応方針の検討のみ(修正不要と判断される可能性が高い場合):
git fetch origin <headRefName> + FETCH_HEADの読解でも可
4. 指摘内容の理解と対応方針の提示
- 該当コード(コメントのpath/line周辺)をReadし、指摘の妥当性を判断
- 対応方針を提示: (a) 指摘通り修正 / (b) 代替案で修正 / (c) 修正不要(理由を返信)
- 判断が分かれる場合や指摘が仕様に関わる場合はユーザーに確認する(Claude Code: AskUserQuestion)
5. 実装対応
- 修正を実装し、品質チェック(PJ CLAUDE.mdのコマンド)を実行
- コミットは/commitスキル準拠(git-cz形式・絵文字なし)。push可否はユーザー指示に従う
6. 返信ドラフト作成
ukwhatn-writingの文体(GitHubレビュー返信)で返信ドラフトを作成し、対応コミットのハッシュを添えて提示する。
投稿はユーザー確認後(対外コミュニケーションのため勝手に投稿しない):
gh api repos/<owner>/<repo>/pulls/<number>/comments/<id>/replies -f body='<返信本文>'
注意事項
- 返信の自動投稿禁止(必ずドラフト提示→ユーザー承認)
- 同一PRに複数の指摘対応を依頼された場合は、指摘ごとに対応方針を整理してから着手する(コミットは指摘単位で分割)
- コメントが解決済み(resolved)またはoutdatedの場合はその旨を報告して指示を仰ぐ
既存設定への参照
- @context/workflow-rules.md