PRマージワークフロー

責任範囲: PR作成 → CIチェック → マージ → クリーンアップ

| このスキル | ci-workflow | |-----------|-------------| | PR作成テンプレート | CIポーリング・ログ分析 | | マージ戦略選択 | 失敗時の自動修正 | | ロールバック手順 | リトライ管理（3回） | | クリーンアップ | 成功時の自動マージ呼び出し |

PR作成

基本コマンド

gh pr create --title "<タイトル>" --body "$(cat <<'EOF'
## Summary
<1-3 bullet points summarizing changes>

## Related Issues
Closes #XX

## Changes
- <specific change 1>
- <specific change 2>

## Testing
- [ ] Tests passed
- [ ] Lint passed
- [ ] Manual verification (if applicable)
EOF
)"

必須要素

| 要素 | 説明 | 例 | |------|------|-----| | Closes #XX | Issue自動クローズ | Closes #42 | | Summary | 変更概要（1-3行） | バグ修正、機能追加等 | | Changes | 具体的な変更リスト | ファイル、関数等 |

CIチェック待機

PR作成後、CIが完了するまで待機する。

# CI完了まで待機（必須）
gh pr checks <pr-number> --watch

重要: CIが失敗した場合はマージせず、修正を行う。

PRマージ

標準マージコマンド

# CI成功後にマージ + ブランチ削除
gh pr merge <pr-number> --merge --delete-branch

マージ戦略

| 戦略 | 用途 | コマンド | |------|------|---------| | --merge | 通常（履歴保持） | gh pr merge --merge | | --squash | WIPコミットが多い場合 | gh pr merge --squash | | --rebase | 線形履歴が必要な場合 | gh pr merge --rebase |

Worktreeエラー対応

--delete-branch がworktreeエラーで失敗する場合：

# 1. ブランチ削除なしでマージ
gh pr merge <pr-number> --merge

# 2. 後でブランチを手動削除
git push origin --delete <branch-name>

マージ後クリーンアップ

必須手順

# 1. Issue自動クローズを確認（Closes #XX使用時）
gh issue view <issue-number>  # Should show "CLOSED"

# 2. 環境削除（コンテナ・ファイル・JSON一括削除）
bash .claude/skills/delete-environment/scripts/delete_env.sh <env_id>

GitHub Issue ラベル更新

環境削除後、Issue のラベルを更新します（@.claude/skills/github-issue-state-management/SKILL.md API）：

bash .claude/skills/github-issue-state-management/scripts/issue-state.sh merged <issue-number>

ロールバック手順

マージ後に問題が発覚した場合：

1. 問題の切り分け

| 問題の種類 | 対応 | |-----------|------| | 軽微なバグ | 新しいPRで修正 | | 重大なバグ | git revert でロールバック | | セキュリティ問題 | 即座にロールバック |

2. Revertコマンド

# 通常のコミット
git revert <commit-hash>

# マージコミット
git revert -m 1 <merge-commit-hash>

# Revert用PRを作成
gh pr create --title "revert: <original PR title>" --body "## Rollback
Reverts PR #<original-pr-number>

**Reason**: <問題の説明>
"

# 緊急時は管理者権限でマージ
gh pr merge <pr-number> --admin --merge

チェックリスト

PR作成前

[ ] 実装完了
[ ] テスト通過
[ ] Lint通過
[ ] 品質レビュー通過（9点以上）

PR作成時

[ ] Closes #XX でIssue参照
[ ] Summary記載
[ ] 変更リスト記載

マージ前

[ ] CI全て通過
[ ] コードレビュー承認

マージ後

[ ] Issue自動クローズ確認
[ ] 環境削除（delete_env.sh 実行）
[ ] Issue ラベル更新（env:merged）

CLIスクリプト

PRマージ完全フローの自動化スクリプト：

bash .claude/skills/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number> [env-id]

| 引数 | 説明 | 必須 | |------|------|------| | pr-number | PR番号 | ✅ | | env-id | container-use環境ID（クリーンアップ用） | - |

処理フロー：

CI完了待機（ci-wait.sh呼び出し）
PRマージ（gh pr merge --merge --delete-branch）
Issue ラベル更新（env:merged）
環境削除（env-id指定時）

使用例：

bash .claude/skills/pr-merge-workflow/scripts/pr-merge-full.sh 42 abc-123-def