Fix PR
レビューコメントを読み、修正を実装し、プッシュし、スレッドに返信します。
呼び出し
/fix-pr # 現在のブランチのPRを修正
/fix-pr 42 # PR #42を修正
フロー
1. PRを特定してチェックアウトする
gh pr view <PR> --json number,title,headRefName,state
PRがクローズまたはマージされている場合は拒否します。
現在のブランチがPRブランチでない場合(/developerパイプラインは新しいワークツリーでこれを実行します)、最初にチェックアウトします:
gh pr checkout <PR>
git checkout main は絶対に実行しないでください。リンクされたワークツリーでは、プライマリワークツリーで main がチェックアウトされているため失敗します。
2. すべてのフィードバックを読む
# トップレベルのコメント
gh pr view <PR> --comments
# レビュースレッド(インライン)
gh api repos/{owner}/{repo}/pulls/<PR>/comments \
--jq '[.[] | {id, path, line, body, in_reply_to_id}]'
# レビューサマリー
gh api repos/{owner}/{repo}/pulls/<PR>/reviews \
--jq '[.[] | select(.body != "") | {id, state, body}]'
未解決のインラインスレッド、レビューサマリーコメント、トップレベルのPRコメントを収集します。
アクションすべきフィードバックがない場合は拒否します。
3. 修正を実装する
- すべての未解決のコメントに対応する
- 変更は最小限に保つ — フィードバックが要求したものだけ
- 無関係なコードはリファクタリングしない
- すべての修正を適用した後:プロジェクトのチェックを実行する(正確なコマンドは
AGENTS.md/CLAUDE.mdを参照)、通常は:
pnpm typecheck
pnpm test
失敗があればコミット前に修正する。
4. コミットしてプッシュする
git add <変更したファイル> # パスでステージ — `git add -p`(対話的)や `git add -A` は絶対に使用しない
git commit -m "fix(pr): #<PR> のレビューコメントに対応"
git push origin <ブランチ>
5. スレッドに返信する
対応した各スレッドに返信する:
gh api repos/{owner}/{repo}/pulls/<PR>/comments/<COMMENT_ID>/replies \
--method POST \
--field body="<コミットSHA>で修正: <何が変更されたかの1行説明>。"
6. 報告する
対応した各コメントとその内容をリストアップする。スキップしたコメントがあれば、その理由も記載する。
ルール
- すべての修正は1つのコミットにまとめる(コメントごとに1つではない)
- 対応したすべてのスレッドに返信する
- コメントが不明瞭な場合:最も合理的な解釈を行い、実装し、スレッドの返信でその解釈を明記する(無人 — 誰も尋ねられません)。コメントが間違っている場合、実装する代わりに返信でその理由を述べる
- 修正によってテストが壊れる場合:報告し、壊れたコードをフォースプッシュしない
- スレッドを解決しないでください — GitHubはプッシュ時に自動的に解決します