---
name: pr-description-generator
description: Generate comprehensive pull request descriptions with summaries and test plans. Use when creating PR descriptions or documenting code changes.
---

# PR Description Generator Skill

包括的なプルリクエスト説明を生成するスキルです。

## 概要

変更内容から、レビュアーに分かりやすいPR説明を自動生成します。

## 主な機能

- **変更サマリー**: 何を変更したか
- **変更理由**: なぜ変更したか
- **テスト計画**: どうテストするか
- **スクリーンショット**: UI変更の場合
- **チェックリスト**: 確認事項
- **Breaking Changes**: 互換性情報

## 生成テンプレート

```markdown
## 📝 概要

[変更の簡潔な説明]

## 🎯 変更の目的

[なぜこの変更が必要か]

Fixes #[Issue番号]

## 🔧 変更内容

- [ ] 機能A を追加
- [ ] バグB を修正
- [ ] パフォーマンス改善C

## 📸 スクリーンショット（該当する場合）

### Before
[変更前のスクリーンショット]

### After
[変更後のスクリーンショット]

## 🧪 テスト計画

- [ ] ユニットテスト追加/更新
- [ ] 統合テスト実施
- [ ] 手動テスト完了
- [ ] E2Eテスト通過

**テスト手順:**
1. ...
2. ...

## 📋 チェックリスト

- [ ] コードレビュー済み
- [ ] テスト追加済み
- [ ] ドキュメント更新済み
- [ ] Breaking Changesの場合、マイグレーションガイド作成
- [ ] セキュリティ影響を確認

## 🚨 Breaking Changes

[該当する場合のみ]

**変更内容:**
...

**マイグレーション方法:**
...

## 📚 関連リンク

- [関連Issue](...)
- [デザインドック](...)
- [技術仕様書](...)

## 💬 レビュー観点

以下の点を特に確認してください：
- ...
- ...
```

## 生成例

### 新機能追加

```markdown
## 📝 概要

ユーザーダッシュボードにリアルタイム通知機能を追加しました。

## 🎯 変更の目的

ユーザーが重要なイベントをすぐに確認できるようにするため。
これにより、ユーザーエンゲージメントが向上することが期待されます。

Fixes #234

## 🔧 変更内容

- [x] WebSocket接続の実装
- [x] 通知コンポーネントの作成
- [x] 通知設定画面の追加
- [x] バックエンドAPI の実装
- [x] Redis Pub/Subの統合

**主要な変更ファイル:**
- `src/components/Notification.tsx` (新規)
- `src/services/websocket.ts` (新規)
- `backend/api/notifications.py` (新規)
- `backend/websocket/server.py` (変更)

## 📸 スクリーンショット

### 通知ポップアップ
![Notification](https://example.com/notification.png)

### 設定画面
![Settings](https://example.com/settings.png)

## 🧪 テスト計画

- [x] ユニットテスト追加（カバレッジ: 92%）
- [x] WebSocket接続テスト
- [x] 複数ブラウザでの動作確認
- [x] 負荷テスト（1000同時接続）

**手動テスト手順:**
1. ログイン
2. ダッシュボードを開く
3. 別のユーザーから通知をトリガー
4. リアルタイムで通知が表示されることを確認
5. 通知設定でオン/オフを切り替え
6. 設定が保存されることを確認

## 📋 チェックリスト

- [x] ESLint/Prettier でフォーマット
- [x] TypeScript型エラーなし
- [x] テストカバレッジ 90%以上
- [x] ドキュメント更新（README、API仕様）
- [x] セキュリティレビュー完了
- [x] パフォーマンステスト通過
- [ ] デザインレビュー待ち

## 🚨 Breaking Changes

なし

## 📚 関連リンク

- [デザイン仕様](https://figma.com/...)
- [技術設計書](https://docs.google.com/...)
- [WebSocket仕様](https://github.com/...)

## 💬 レビュー観点

以下の点を特に確認してください：
- WebSocket接続の安定性
- 通知の表示タイミング
- エラーハンドリング
- メモリリーク の有無
- モバイル表示の確認

## 📊 パフォーマンス影響

- 初回ロード時間: +50ms（許容範囲内）
- メモリ使用量: +2MB（WebSocket接続時）
- CPU使用率: 変化なし
```

### バグ修正

```markdown
## 📝 概要

決済フローで発生していたタイムアウトエラーを修正しました。

## 🎯 変更の目的

本番環境で断続的に発生していた決済失敗（約5%）を解消します。

Fixes #789

## 🔧 変更内容

**根本原因:**
外部決済APIへのリクエストタイムアウトが3秒と短すぎた。
ネットワーク遅延により、タイムアウトが頻発していた。

**修正内容:**
- [x] タイムアウトを3秒→10秒に延長
- [x] リトライロジックの追加（最大3回）
- [x] エラーログの改善
- [x] ユーザーへのフィードバック改善

## 🧪 テスト計画

- [x] ユニットテスト更新
- [x] ネットワーク遅延シミュレーション
- [x] ステージング環境で100回の決済テスト（成功率100%）
- [x] エラーケースのテスト

## 📋 チェックリスト

- [x] コードレビュー済み
- [x] 本番ログで原因確認
- [x] ステージングで検証完了
- [x] ホットフィックスとして即デプロイ可能

## 🚨 影響範囲

**本番環境への影響:**
- ダウンタイムなし
- 既存の決済処理に影響なし
- 後方互換性あり

**期待される効果:**
- 決済成功率: 95% → 99.5%
- ユーザー満足度向上
```

## バージョン情報

- スキルバージョン: 1.0.0
- 最終更新: 2025-01-22