# Pr Review Handler

> プルリクエストのレビューコメントに体系的に対応するスキル。未解決コメントを取得し、問題を分析し、修正案を提案し、コメント単位でコミットを作成し、手動での返信とresolveをガイドします。GitHubのPRレビューに構造化された整理された対応が必要な場合に使用してください。

- Skill: `majiayu000/pr-review-handler` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add majiayu000/pr-review-handler`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/pr-review-handler/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/pr-review-handler

---


# PRレビューハンドラー

## 概要

プルリクエストのレビューコメントを構造化された体系的な方法で処理します。このスキルは、GitHubから未解決のレビューコメントを取得し、各問題を分析し、詳細な修正案を提案し、コメントごとのコミット作成をガイドし、手動返信による人間味のあるコミュニケーションをサポートします。

## このスキルを使用する場合

以下の場合にこのスキルを使用:
- ユーザーがPRレビューコメントに対応する必要がある
- 複数のレビューコメントを整理して処理する必要がある
- レビューコメントを個別のコミットで対応したい
- 人間的なコミュニケーションを保ちながらレビュー問題の修正ガイダンスが必要

## ワークフロー

PRレビューを体系的に処理するには、`/resolve-review`コマンドを使用します。

このスキルは`/resolve-review`コマンドと統合されており、以下のワークフローを自動的に実行します:

### 1. 未解決コメントの取得

`/resolve-review`コマンドが`scripts/get_unresolved_reviews.sh`を使用して未解決のレビュースレッドを取得します。

未解決コメントが存在しない場合は、ユーザーに通知して終了。

### 2. 各コメントを個別に処理

各未解決コメントに対して:

**a) コメントのコンテキストを表示:**
- コメント番号: `[1/5]`
- ファイルと行: `src/utils/helper.ts:42`
- レビュアー: `@username`
- コメント本文(マークダウン形式)
- 関連コード(diffHunkまたはファイルを読み込んで取得)

**b) 問題を分析:**
- レビュアーは何を懸念しているか?
- なぜこれが問題なのか?
- 影響は何か?

**c) 修正案を提案:**
- `path`と`line`情報を使用して現在のコードを読み込む
- 詳細な修正提案を生成し、以下を説明:
  - 具体的な問題点
  - なぜ修正が必要か
  - どう修正するか(具体的なコード変更)
  - どのファイルとどの行を修正するか

**d) ユーザーが修正を実装:**
- ユーザーがエディタで提案された変更を手動で実装
- ユーザーが必要に応じて変更をテスト

**e) コメント単位でコミットを作成:**

ユーザーが実装を確認した後、焦点を絞ったコミットを作成:

```bash
git add <修正したファイル>
git commit -m "fix: <簡潔な説明>

PR #<番号>の@reviewerからのレビューコメントに対応
<修正の詳細説明>
"
```

**重要:** 履歴を明確にし追跡しやすくするため、1つのレビューコメントにつき1つのコミットを作成。

**f) ユーザーが手動で返信:**

GitHubで手動で返信を投稿するようユーザーに通知します。これにより、コードレビューの会話における人間味が保たれます。

返信テンプレートの例:
- "Fixed in <commit-hash>! Thanks for catching this."
- "ご指摘の手法を使って更新しました。良い指摘です!"
- "推奨通りにリファクタリングしました。レビューありがとうございます!"

手動返信により人間的な温かみと個人的なコミュニケーションが維持されることを強調します。

### 3. すべてのコメントに対して繰り返し

ステップ2a-2fを繰り返して、すべての未解決コメントを処理します。

### 4. 最終サマリー

すべてのコメント処理後、以下を表示:
- 処理したコメントの総数
- 作成したコミット数
- 変更をプッシュするリマインダー: `git push`
- オプション: REVIEW_NOTES_{PR番号}.md追跡ファイルを作成

## スラッシュコマンド統合

このスキルは`/resolve-review`コマンドと統合されています。

### 使用方法

```
/resolve-review [PR番号またはURL]
```

`/resolve-review`コマンドは以下を自動的に実行します:
- 現在のブランチまたは指定されたPRの未解決コメントを取得
- 各コメントを順番に表示し、修正案を提案
- コメント単位でのコミット作成をガイド
- ユーザーの手動返信を促進

## スクリプト

### get_unresolved_reviews.sh

GitHub GraphQL APIを使用して未解決のレビュースレッドを取得します。

**注意:** このスクリプトは`/resolve-review`コマンドから自動的に呼び出されます。直接実行する必要は通常ありません。

**手動使用方法(上級者向け):**
```bash
./scripts/get_unresolved_reviews.sh <owner> <repo> <pr番号>
```

**出力:** 完全なコメント詳細を含む未解決レビュースレッドのJSON配列

**要件:** 認証済みの`gh` CLIツール

## リファレンス

### workflow.md

PRレビューを体系的に処理するための段階的な手順を含む詳細なワークフロードキュメント。

### github_api.md

レビュースレッド用のGitHub GraphQL APIリファレンス。クエリ構造とフィールドドキュメントを含む。

## 重要な注意事項

- **コメント単位のコミット:** 履歴を明確にするため、常に1つのレビューコメントにつき1つのコミットを作成
- **人間的な返信:** 返信を自動化しない - コミュニケーション品質を保つため、ユーザーが手動で返信すべき
- **順次処理:** 混乱を避けるため、コメントは一度に1つずつ処理
- **コンテキストが重要:** 修正案を提案する際は、常に関連するコードのコンテキストを表示
- **進捗追跡:** オプションでREVIEW_NOTES_{PR番号}.mdを使用して処理済みコメントを追跡