PR作成スキル

現在のブランチの変更内容を分析し、PRを作成する。

ルール

• PRは ippei-shimizu/buzzbase リポジトリに作成する
• ベースブランチはデフォルトで stg（$ARGUMENTS で指定があればそちらを使用）
• すべて日本語で記述する
• 作成前に必ずユーザーの承認を得る
• リモートにプッシュされていない場合は先にプッシュする

ワークフロー

1. 現在のブランチ状態を確認

bash
1# 現在のブランチ名
2git branch --show-current
3
4# 未コミットの変更がないか確認
5git status --short
6
7# リモートとの同期状態を確認
8git log origin/$(git branch --show-current)..HEAD --oneline 2>/dev/null
9
10# ベースブランチからの全コミット
11git log stg..HEAD --oneline
12
13# ベースブランチからの全差分
14git diff stg...HEAD --stat

未コミットの変更がある場合はユーザーに通知し、先にコミットするか確認する。

2. 差分の分析

ベースブランチからの全コミットと差分を分析する:

bash
1# コミットメッセージ一覧
2git log stg..HEAD --format="%s"
3
4# 変更ファイル一覧
5git diff stg...HEAD --stat
6
7# 詳細な差分（大きい場合はサブエージェントで分析）
8git diff stg...HEAD

以下を把握する:

• 変更されたファイルとその種類（新規/変更/削除）
• 実装の目的と内容
• 影響範囲（front / back / 両方 / その他）
• 関連するissue番号（ブランチ名やコミットメッセージから推測）

3. PRタイトルの生成

• コミット履歴と差分から変更の主目的を要約する
• 70文字以内の簡潔な日本語タイトル
• $ARGUMENTS にタイトルのヒントがあればそれを優先する

4. PR descriptionの生成

/pr-description スキルと同じテンプレートに沿って生成する:

markdown
1## issue
2close #ISSUE_NUMBER
3
4## 実装概要
5<!-- 何をしたかを簡潔に（1-3行） -->
6
7## 背景
8<!-- なぜこの変更が必要だったか -->
9
10## やらなかったこと
11<!-- スコープ外にしたこと。なければ「特になし」 -->
12
13## 受入基準
14<!-- この PR がマージ可能と判断するための条件をチェックリストで -->
15- [ ] 基準1
16- [ ] 基準2
17
18## 実装詳細
19<!-- 技術的な実装内容。ファイル単位やモジュール単位で説明 -->
20
21## スクリーンショット
22<!-- UI変更がある場合のみ。なければ「なし」 -->
23
24## 確認手順
25<!-- レビュワーが動作確認するための具体的な手順 -->
261. 手順1
272. 手順2
28
29## 影響範囲
30<!-- この変更が影響する画面・機能・モジュール -->
31
32## コード上の懸念点
33<!-- レビュワーに特に見てほしい箇所や、判断に迷った実装 -->
34
35## その他
36<!-- 補足情報。なければ「特になし」 -->

5. ユーザーに確認

作成内容を以下のフォーマットでプレビュー表示し、承認を待つ:

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PR プレビュー
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
ブランチ: <head-branch> → <base-branch>
タイトル: <タイトル>

本文:
<description プレビュー>
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

ユーザーの明示的な承認（「OK」「作成して」等）を待つ。承認前にPRを作成してはならない。 フィードバックがあれば修正して再度プレビューを表示する。

6. プッシュとPR作成

承認後、以下の順序で実行する:

bash
1# リモートにプッシュされていない場合
2git push -u origin $(git branch --show-current)
3
4# PR作成
5gh pr create \
6  --repo ippei-shimizu/buzzbase \
7  --base stg \
8  --title "<タイトル>" \
9  --body "$(cat <<'EOF'
10<description内容>
11EOF
12)"

7. 結果報告

作成されたPRのURLを表示する。

注意事項

• ユーザーの承認なしにPRを作成しない
• ユーザーの承認なしに git push しない
• 差分から読み取れる事実に基づいて記述し、推測が入る箇所は明示する
• issue番号がブランチ名やコミットから特定できない場合は close # の行は空欄にする（推測で番号を入れない）
• $ARGUMENTS が指定された場合、それをPRの背景コンテキストとして活用する
• 会話の文脈（直前の実装作業など）がある場合は、それを活用してdescriptionを充実させる