Pr Merge Workflow

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
)"

必須要素

CIチェック待機

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

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

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

PRマージ

標準マージコマンド

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

マージ戦略

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 .opencode/skill/delete-environment/scripts/delete_env.sh <env_id>

GitHub Issue ラベル更新

環境削除後、Issue のラベルを更新します（{{skill:github-issue-state-management}} API）：

bash .opencode/skill/github-issue-state-management/scripts/issue-state.sh merged <issue-number>

ロールバック手順

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

1. 問題の切り分け

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 .opencode/skill/pr-merge-workflow/scripts/pr-merge-full.sh <pr-number> [env-id]

処理フロー：

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

使用例：

bash .opencode/skill/pr-merge-workflow/scripts/pr-merge-full.sh 42 abc-123-def