pr-summary-generatorlisted
Install: claude install-skill ttamakijp/dev-templates
# pr-summary-generator
`git diff main...HEAD` を解析し、PR テンプレートを埋めた説明文を生成する。
## いつ使うか
- PR 作成直前に説明文を起草したい
- 変更が多岐にわたり、要点整理が必要
- レビュアに見てほしいポイントを明示したい
## 手順
### 1. ベース情報を取得
```bash
git fetch origin main
git log origin/main..HEAD --pretty='%h %s' # コミット一覧
git diff origin/main...HEAD --stat # ファイル別変更量
git diff origin/main...HEAD --name-only # 変更ファイル一覧
```
### 2. 分類
| カテゴリ | 判別パターン |
|---------|------------|
| 新機能 | `feat:` コミット、新規ファイル多い |
| バグ修正 | `fix:` コミット、既存ファイル小幅変更 |
| リファクタ | `refactor:` コミット、テスト追加なし |
| ドキュメント | `*.md` のみ |
| 依存更新 | `package.json` / `build.gradle.kts` のみ |
### 3. テンプレート埋め
```markdown
## 概要
(コミ��ト件名から 1-3 行で要約)
## 動機・背景
(なぜこの変更が必要か。issue があればリンク)
## 変更内容
- (変更ファイルから主要 3-5 件)
## 動作確認
- [ ] ユニットテスト PASS
- [ ] ビルド成功
- [ ] 既存機能の回帰なし
## レビュー観点
(特に注意してほしい設計判断・トレードオフ)
## 関連 issue / PR
Closes #XXX
```
### 4. gh CLI で作成
```bash
gh pr create --title "<title>" --body "$(cat <<'EOF'
## 概要
...
EOF
)"
```
## チェックリスト
- [ ] 概要は 1-3 行(長文 README 化しない)
- [ ] 「変更内容」は実装詳細でなく要点のみ
- [ ] 動作確認チェックボックスを実態に合わせて埋める
- [ ] BREAKING CHANGE があれば冒頭に明記
- [ ] スクリーンショット・動画を必要に応じて添付
- [ ] 関連 issue を `Closes #N` で自動クローズ設定
## アンチパターン
- diff をそのまま貼り付ける(レビュアの認知負荷増)
- 「全変更ファイルリスト」を本文に入れる(GitHub UI で見れる)
- 動作確認なし PR