GitHub PR管理

GitHubのプルリクエストを管理するためのスキル。

重要な制約

このスキルは sh1ma/blog リポジトリのみで使用すること。 他のリポジトリの操作は禁止。--repo フラグで他リポジトリを指定してはならない。

利用可能なラベル

PRには必ず以下のいずれかのラベルを付けること:

PR作成手順（推奨フロー）

1. 変更内容の確認

bash
1# mainからの差分コミットを確認
2git log main..HEAD --oneline
3
4# 変更ファイルを確認
5git diff main..HEAD --stat

2. 適切なラベルを選択

変更内容に基づいて、上記のラベルから1つ以上選択する。

3. PRを作成

重要: .github/pull_request_template.md のテンプレートを必ず遵守すること。

bash
1gh pr create \
2  --title "タイトル" \
3  --label "ラベル" \
4  --assignee sh1ma \
5  --body "$(cat <<'EOF'
6## 概要
7
8<!-- このPRで何を変更したか簡潔に説明 -->
9
10## 変更内容
11
12- 変更点1
13- 変更点2
14
15## 関連Issue
16
17<!-- closes #123 -->
18
19## テスト項目
20
21- [ ] テスト項目1
22- [ ] テスト項目2
23
24## VRT設定
25
26<!-- UIに意図的な変更がある場合のみチェックしてください -->
27
28- [ ] スナップショットを更新する（UI変更を意図的に行った場合にチェック）
29
30## スクリーンショット（任意）
31
32<!-- UIの変更がある場合はスクリーンショットを貼ってください -->
33
34## 備考
35
36<!-- レビュアーに伝えたいことがあれば記載してください -->
37EOF
38)"

複数ラベルを付ける場合

bash
1gh pr create --title "タイトル" --label "feature" --label "AI" --assignee sh1ma --body "..."

コマンド概要

bash
1gh pr <command> [flags]

主要コマンド

PR一覧表示

bash
1gh pr list                    # 現在のリポジトリのPR一覧
2gh pr list --state all        # すべてのPR（open/closed/merged）
3gh pr list --author @me       # 自分が作成したPR
4gh pr list --assignee @me     # 自分がアサインされたPR
5gh pr list --label "bug"      # ラベルでフィルタ

PR表示・チェックアウト

bash
1gh pr view                    # 現在のブランチのPRを表示
2gh pr view 123                # PR #123を表示
3gh pr view --web              # ブラウザで開く
4gh pr view --comments         # PRのコメントを表示（会話コメントのみ）
5gh pr checkout 123            # PR #123をチェックアウト
6gh pr diff 123                # PR #123の差分を表示

PRコメント表示

PRのコメントを確認する方法は複数あります。

基本的なコメント表示

bash
1# 会話コメントを表示（gh pr viewのデフォルト出力に含まれる）
2gh pr view 123 --comments
3
4# JSONフォーマットで詳細情報を取得
5gh pr view 123 --json comments
6
7# すべてのコメント（インラインレビューコメント含む）をAPI経由で取得
8gh api repos/sh1ma/blog/pulls/123/comments

コメントの種類

• 会話コメント（Issue comments）: PR全体に対するコメント。gh pr view --comments で表示可能
• レビューコメント（Review comments）: コードの特定行に対するインラインコメント。API経由で取得
• レビュー（Reviews）: 承認/変更要求/コメント。gh pr view --json reviews で取得可能

実用例

bash
1# 現在のブランチのPRのコメントを確認
2gh pr view --comments
3
4# PR #123のすべてのインラインコメントを確認
5gh api repos/sh1ma/blog/pulls/123/comments | jq -r '.[] | "\(.path):\(.line) - \(.user.login): \(.body)"'
6
7# PR #123のレビュー状況を確認
8gh pr view 123 --json reviews | jq -r '.reviews[] | "\(.author.login): \(.state) - \(.body)"'

PRマージ・クローズ

bash
1gh pr merge                   # 現在のブランチのPRをマージ
2gh pr merge 123               # PR #123をマージ
3gh pr merge --squash          # スカッシュマージ
4gh pr merge --rebase          # リベースマージ
5gh pr merge --delete-branch   # マージ後にブランチ削除
6gh pr close 123               # PR #123をクローズ
7gh pr reopen 123              # PR #123を再オープン

PRレビュー

bash
1gh pr review                           # 対話形式でレビュー
2gh pr review 123 --approve             # 承認
3gh pr review 123 --request-changes -b "修正必要"
4gh pr review 123 --comment -b "コメント"
5gh pr checks 123                       # CIステータス確認

PR編集

bash
1gh pr edit 123 --title "新タイトル"
2gh pr edit 123 --body "新本文"
3gh pr edit 123 --add-label "bug"
4gh pr edit 123 --add-reviewer user1
5gh pr ready 123                        # ドラフト解除

Visual Regression Test (VRT) について

PRを作成すると、自動でVRTが実行されます。

VRTの動作

1. R2からベースライン（mainブランチの最新スナップショット）を取得
2. PRのコードでスクリーンショットを撮影
3. ベースラインと比較して差分を検出
4. PRにコメントで結果を通知（レポートURLと差分画像）

UIに意図的な変更を加えた場合

1. PRテンプレートの「VRT設定」セクションで「スナップショットを更新する」にチェック
2. VRTワークフローが再実行され、新しいスナップショットがR2にアップロード
3. マージ後、自動でベースラインが更新される

VRTが失敗した場合

• 意図しない変更: コードを修正してVRTを再実行
• 意図した変更: 「スナップショットを更新する」にチェックして再実行

ラベル

VRTに関連するPRには test ラベルも追加することを推奨します。

実行手順

1. ユーザーの要求を理解する
2. PR作成の場合、変更内容を確認してラベルを決定する
3. .github/pull_request_template.md のテンプレートを遵守してPRを作成する
4. ラベルを必ず付けてPRを作成する
5. assigneeを sh1ma に設定してPRを作成する
6. PRコメント確認の場合、適切なコマンド（gh pr view --comments、gh apiなど）を使用する
7. 結果を日本語で報告

注意事項

• PRは番号、URL、またはブランチ名で指定可能
• 認証が必要な場合は gh auth login を案内
• 他リポジトリへの操作は絶対に行わない
• PR作成時はラベルを必ず付けること（CIでチェックされる）
• PR作成時はassigneeを sh1ma に必ず設定すること