# pr-review-handler

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

- Author: nyatinte
- Repository: nyatinte/dotfiles
- Version: 20260120171923
- Stars: 1
- Forks: 0
- Last Updated: 2026-02-06
- Source: https://github.com/nyatinte/dotfiles
- Web: https://mule.run/skillshub/@@nyatinte/dotfiles~pr-review-handler:20260120171923

---

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

# 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を使用して処理済みコメントを追跡