pr

PR作成

このプロジェクトのコードをcommit, pushし、GitHubでPull Requestを作成する。

制約: デフォルトブランチ(main, masterなど)で直接コミット禁止

手順

0. PR確認

   • git branch --show-currentで現在ブランチ確認
   • github mcpまたはghで現在のbranchから作成されているPRを確認
   • 既にPRが存在しOPEN状態ならgit add → git commit → git pushして終了（日本語メッセージ）
     • 上位階層含むすべての変更をcommit
   • PRがない、またはmerge/close済みなら次へ

1. ブランチ確認・切り替え

   • デフォルトブランチの場合: 新featureブランチ作成→切り替え
   • デフォルトブランチ以外: git stash → git pull origin [デフォルトブランチ]（コンフリクト時は停止しユーザに報告） → stash復帰

2. 変更コミット

   • git status→git add→git commit（日本語メッセージ）
   • 上位階層含むすべての変更をcommit

3. プッシュ

   • git push -u origin <branch-name>

4. PR作成

   • ベースブランチ: $ARGUMENTS が渡された場合はそのブランチ、なければデフォルトブランチ
   • タイトル・説明: 日本語、body: Summary+Test plan
   • 機密情報（トークン、パスワード、APIキー等）を含めないこと
   • body末尾に <!-- I want to review in Japanese. --> を入れる
   • bodyは必ずHEREDOC形式で渡すこと（\nリテラル混入防止）:

     gh pr create --title "タイトル" --body "$(cat <<'EOF'
     ## Summary
     - 変更内容
     
     ## Test plan
     - [ ] テスト項目
     
     <!-- I want to review in Japanese. -->
     EOF
     )"
     

命名規則

• ブランチ: 英語（github flow）
• コミット・PR: 日本語

検証ブランチ（qa/epsilon等）へのPR作成手順

重要: featureブランチから直接検証ブランチへPRを作成してはいけません。

アンチパターン（禁止）

feature/xxx ──PR──→ qa/epsilon   ← ❌ qa/epsilonをmergeするとmainが汚染される

qa/epsilonをfeature/xxxにmergeしてconflictを解消すると、feature/xxx → mainのPRにqa/epsilon固有のコードが混入します。

正しい手順（cherry-pick方式）

1. 検証ブランチから短命ブランチを作成
2. featureブランチから必要なコミットだけをcherry-pick
3. 短命ブランチから検証ブランチへPRを作成

# 1. 検証ブランチの最新を取得
git fetch origin qa/epsilon

# 2. 検証ブランチから短命ブランチを作成
git checkout -b feature/xxx-for-epsilon origin/qa/epsilon

# 3. featureブランチから必要なコミットをcherry-pick
git log --oneline main..feature/xxx  # コミット一覧を確認
git cherry-pick <commit-hash-1> <commit-hash-2> ...

# 4. conflictがあれば解決してcontinue
git cherry-pick --continue

# 5. pushしてPR作成
git push -u origin feature/xxx-for-epsilon
gh pr create --base qa/epsilon --title "feat: ○○機能（epsilon検証用）" --body "$(cat <<'EOF'
## Summary
- feature/xxxからcherry-pickした検証用PR

## Test plan
- [ ] 検証環境で動作確認

<!-- I want to review in Japanese. -->
EOF
)"

コミット選定のコツ

# featureブランチの全コミットを確認（mainから分岐後）
git log --oneline main..feature/xxx

# 特定ファイルに関するコミットだけ確認
git log --oneline main..feature/xxx -- path/to/file

まとめ

ケース	方法
feature/xxx → main	通常通りPR作成
feature/xxx → qa/epsilon	短命ブランチ + cherry-pickでPR作成
conflict解消でqa/epsilonをmerge	❌ 禁止（main汚染の原因）

作業完了報告（必須）

PR作成完了後、以下を報告:

• 基本情報（PRタイトル、ベース/ソースブランチ）
• 変更サマリー（コミット数、変更ファイル数、変更行数、主な変更内容）
• コミット履歴
• PR本文の概要（Summary、Test plan）
• PR URL