finishing-a-development-branch

開発ブランチの仕上げ

概要

明確な選択肢を提示し、選択されたワークフローを実行して、開発作業の完了を支援します。

基本原則： テストを確認 → 選択肢を提示 → 選択された項目を実行 → クリーンアップ。

開始時に宣言： 「開発ブランチを仕上げるため、このスキルを使用します。」

手順

ステップ 1：テストを確認する

選択肢を提示する前に、テストが成功することを確認します：

# Run project's test suite
npm test / cargo test / pytest / go test ./...

テストが失敗した場合：

Tests failing (<N> failures). Must fix before completing:

[Show failures]

Cannot proceed with merge/PR until tests pass.

停止します。ステップ 2 に進まないでください。

テストが成功した場合： ステップ 2 に進みます。

ステップ 2：ベースブランチを特定する

# Try common base branches
git merge-base HEAD main 2>/dev/null || git merge-base HEAD master 2>/dev/null

または、次のように尋ねます：「このブランチは main から分岐しています。それで合っていますか？」

AGENTS.md とメンテナー向けドキュメントを読み、ベースブランチに適用される保護設定を確認します。プルリクエストや必須チェックが適用されている場合は、ローカルでのマージを選択不可とし、リポジトリで定められたガード付きの PR／マージワークフローを使用します。agentic-awesome-skills では、メンテナーによるマージを antigravity-maintainer-batch-release と npm run merge:batch に委ねます。

ステップ 3：選択肢を提示する

保護されていないベースブランチの場合、次の 4 つの選択肢をそのまま提示します：

Implementation complete. What would you like to do?

1. Merge back to <base-branch> locally
2. Push and create a Pull Request
3. Keep the branch as-is (I'll handle it later)
4. Discard this work

Which option?

説明を追加しないでください ― 選択肢は簡潔にします。

保護されたベースブランチの場合、ローカルでのマージは提示しないでください。push／PR 作成、そのまま保持、破棄のみを提示し、破棄には同じ確認ルールを適用します。

ステップ 4：選択された項目を実行する

オプション 1：ローカルでマージする

リポジトリのポリシーとサーバー側の保護設定によって、ベースブランチへのローカルでの統合が許可されていると確認できた場合に限り、このオプションを使用します。確認できない場合は停止し、オプション 2 に進みます。

# Switch to base branch
git checkout <base-branch>

# Pull latest
git pull

# Merge feature branch
git merge <feature-branch>

# Verify tests on merged result
<test command>

# If tests pass
git branch -d <feature-branch>

その後：ワークツリーをクリーンアップします（ステップ 5）

オプション 2：push して PR を作成する

# Push branch
git push -u origin <feature-branch>

# Create PR
gh pr create --title "<title>" --body "$(cat <<'EOF'
## Summary
<2-3 bullets of what changed>

## Test Plan
- [ ] <verification steps>
EOF
)"

ユーザーが明示的にクリーンアップを依頼しない限り、PR のフォローアップに備えてワークツリーを保持します。

オプション 3：そのまま保持する

次のように報告します：「ブランチ を保持します。ワークツリーは に残します。」

ワークツリーをクリーンアップしないでください。

オプション 4：破棄する

先に確認します：

This will permanently delete:
- Branch <name>
- All commits: <commit-list>
- Worktree at <path>

Type 'discard' to confirm.

正確な確認を待ちます。

確認された場合：

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

その後：ワークツリーをクリーンアップします（ステップ 5）

ステップ 5：ワークツリーをクリーンアップする

オプション 1 と 4 の場合のみ：

ワークツリー内にいるか確認します：

git worktree list --porcelain

ワークツリーの正確なパスを特定し、必要な変更済み、未追跡、または無視対象のファイルが残っていないことを確認します。アプリが管理するワークツリーの場合は、直接削除せず、アプリのアーカイブツールを使用します。それ以外の場合は、必要な証拠を保存した後、次を実行します：

git worktree remove <worktree-path>

オプション 3 の場合： ワークツリーを保持します。

クイックリファレンス

オプション	マージ	push	ワークツリーを保持	ブランチをクリーンアップ
1. ローカルでマージ	✓	-	-	✓
2. PR を作成	-	✓	✓	-
3. そのまま保持	-	-	✓	-
4. 破棄	-	-	-	✓（強制）

よくある間違い

テスト確認を省略する

• 問題： 壊れたコードをマージする、または失敗する PR を作成する
• 対処： 選択肢を提示する前に必ずテストを確認します

自由回答形式の質問

• 問題： 「次に何をすればよいですか？」→ 曖昧
• 対処： 構造化された選択肢を必ず 4 つ提示します

ワークツリーを自動でクリーンアップする

• 問題： 必要になる可能性のあるワークツリーを削除する（オプション 2、3）
• 対処： オプション 1 と 4 の場合のみクリーンアップします

破棄の確認を取らない

• 問題： 作業を誤って削除する
• 対処： 「discard」と入力して確認するよう求めます

注意すべき兆候

絶対に行わないこと：

• テストが失敗している状態で先に進む
• 結果に対するテストを確認せずにマージする
• 確認なしに作業を削除する
• 明示的な依頼なしに force-push する

必ず行うこと：

• 選択肢を提示する前にテストを確認する
• 選択肢を必ず 4 つ提示する
• オプション 4 では入力による確認を得る
• オプション 1 と 4 の場合のみワークツリーをクリーンアップする

連携

呼び出し元：

• subagent-driven-development（ステップ 7）- すべてのタスクが完了した後
• executing-plans（ステップ 5）- すべてのバッチが完了した後

組み合わせて使用：

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

使用するタイミング

このスキルは、概要で説明したワークフローまたは操作を実行する際に使用します。

制限事項

• このスキルは、タスクが上記のスコープに明確に一致する場合にのみ使用してください。
• 出力を、環境固有の検証、テスト、専門家によるレビューの代替として扱わないでください。
• 必要な入力、権限、安全境界、成功基準が欠けている場合は、作業を中断して確認を求めてください。