開発ブランチの完了

概要

開発作業の完了を明確なオプションと選択したワークフローの実行により導くガイド。

主要原則: テスト確認 → オプション提示 → 選択実行 → クリーンアップ

開始時に告知: 「開発ブランチ完了スキルを使用して、この作業を完了します。」

プロセス

Step 1: テスト確認

オプション提示前に、テスト成功を確認:

# プロジェクトのテストスイート実行
npm test / cargo test / pytest / go test ./...

テスト失敗の場合:

テスト失敗(<N>件のエラー)。完了前に修正が必要:

[失敗内容を表示]

テスト成功までマージ/PR作成に進めません。

停止。Step 2に進まない。

テスト成功の場合: Step 2に進む。

Step 2: ベースブランチの確認

# 一般的なベースブランチを確認
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null

または質問: 「このブランチは main から分岐していますね。正しいですか?」

Step 3: オプション提示

正確に以下の4つのオプションを提示:

実装完了。次のいずれかを選択してください:

1. <ベースブランチ>にローカルでマージ
2. プッシュしてプルリクエストを作成
3. ブランチをこのまま保持(あとで対応)
4. この作業を破棄

どのオプションですか?

説明は追加しない - オプションは簡潔に。

Step 4: 選択の実行

オプション1: ローカルでマージ

# ベースブランチに切り替え
git checkout <base-branch>

# 最新を取得
git pull

# フィーチャーブランチをマージ
git merge <feature-branch>

# マージ後のテストを確認
<test command>

# テスト成功の場合
git branch -d <feature-branch>

その後: worktree をクリーンアップ (Step 5)

オプション2: プッシュして PR作成

# ブランチをプッシュ
git push -u origin <feature-branch>

# PR を作成
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<変更内容 2-3箇条>

## Test Plan
- [ ] <検証手順>
EOF
)"

その後: worktree をクリーンアップ (Step 5)

オプション3: ブランチを保持

報告: 「ブランチ <name> を保持します。worktree は <path> に保存されています。」

worktree をクリーンアップしない。

オプション4: 破棄

先に確認:

以下が永久に削除されます:
- ブランチ <name>
- すべてのコミット: <commit-list>
- <path> の worktree

確認するには 'discard' と入力してください。

完全な確認を待つ。

確認後:

git checkout <base-branch>
git branch -D <feature-branch>

その後: worktree をクリーンアップ (Step 5)

Step 5: Worktree クリーンアップ

オプション1, 2, 4の場合:

worktree に存在するか確認:

git worktree list | grep $(git branch --show-current)

存在する場合:

git worktree remove <worktree-path>

オプション3の場合: worktree を保持。

クイックリファレンス

オプション	マージ	プッシュ	Worktree保持	ブランチ削除
1. ローカルでマージ	✓	-	-	✓
2. PR 作成	-	✓	✓	-
3. ブランチ保持	-	-	✓	-
4. 破棄	-	-	-	✓ (強制)

一般的なミス

テスト確認をスキップ

• 問題: 壊れたコードをマージ、失敗する PR を作成
• 対策: オプション提示前に必ずテスト確認

曖昧な質問

• 問題: 「次は何をしましょう?」 → 不明確
• 対策: 正確に4つの構造化オプションを提示

自動的な worktree クリーンアップ

• 問題: worktree が必要な場合も削除(オプション2, 3)
• 対策: オプション1と4のみクリーンアップ

破棄時に確認なし

• 問題: 作業を誤って削除
• 対策: discard の入力確認を必須に

レッドフラグ

禁止:

• テスト失敗時に進む
• マージ結果のテスト確認なしでマージ
• 確認なしで作業を削除
• 明示的な要求なしで force-push

必須:

• オプション提示前にテスト確認
• 正確に4つのオプションを提示
• オプション4に discard 入力確認
• オプション1と4のみ worktree をクリーンアップ

統合

呼び出し元:

• subagent-driven-development (Step 7) - すべてのタスク完了後
• executing-plans (Step 5) - すべてのバッチ完了後

連携スキル:

• using-git-worktrees - そのスキルで作成された worktree をクリーンアップ

使用時期

このスキルは、概要で説明されているワークフローまたはアクション実行に適用されます。

制限事項

• このスキルは上記で説明された範囲に明らかにマッチする場合のみ使用してください。
• 環境固有の検証、テスト、または専門家レビューの代替物としてこのスキルの出力を扱わないでください。
• 必須入力、権限、安全性境界、成功基準が不足している場合は停止し、説明を求めてください。