| name | prune-branches |
| description | ベースブランチにマージ済みのローカル作業ブランチを安全に削除する。 リモートブランチの削除は明示的に指示された場合のみ実行する。 マージ済みブランチの整理、PR マージ後の古いブランチ削除、ローカルやリモートの refs の整頓時に使用する。
|
| allowed-tools | ["Bash(git branch *)","Bash(git log *)","Bash(git remote *)","Bash(git push *)","Bash(git fetch *)","AskUserQuestion"] |
マージ済みブランチの削除
ベースブランチにマージ済みのローカル作業ブランチを安全に削除する。リモートブランチの削除は明示的に指示された場合のみ実行する。
クイックスタート
/prune-branches を実行するか「マージ済みブランチを削除して」と伝える- ベースブランチを確認する（デフォルト:
main）
- マージ済みローカルブランチの一覧を確認 → 承認後に削除する
- リモートブランチの削除は明示的に要求された場合のみ実行する
ステップ
ステップ 1: ベースブランチを特定する
git branch --show-current
git remote
ベースブランチの優先順位:
- 引数またはメッセージでユーザーが指定したブランチ
main が存在する場合はそれを使用master が存在する場合はそれを使用- どちらも存在しない場合は AskUserQuestion で尋ねる
git branch --list main master
ステップ 2: マージ済みのローカルブランチを一覧表示する
git fetch --prune
git branch --merged <base-branch>
常に除外するもの:
- 現在チェックアウト中のブランチ（
* が付いているもの）
- ベースブランチ自体（
main / master など）
- 保護されたブランチ:
develop, staging, release, production
除外後に候補が残らない場合は「削除するブランチがありません」と報告して停止する。
ステップ 3: 候補を提示して確認を取る
候補を表示して AskUserQuestion で確認する:
削除するローカルブランチ（N 件）:
- feature/add-login
- fix/typo-in-readme
- chore/update-deps
これらのブランチを削除しますか？
AskUserQuestion({
questions: [{
question: "上記のブランチを削除しますか？",
header: "ローカルブランチ削除の確認",
options: [
{ label: "すべて削除する", description: "一覧のすべてのブランチを削除する" },
{ label: "選択して削除する", description: "ブランチを個別に選択する" },
{ label: "キャンセル", description: "何も削除せずに終了する" }
],
multiSelect: false
}]
})
「選択して削除する」が選択された場合、ブランチ名を選択肢とする multiSelect の質問で続ける。
ステップ 4: ローカルブランチを削除する
承認された各ブランチに対して安全な削除を実行する:
git branch -d <branch>
-D（強制削除）は絶対に使用しない。-d はブランチが本当にマージ済みであることを確認する最後の安全策である。
-d が失敗した場合（ブランチが完全にマージされていないと報告された場合）:
- ユーザーに状況を報告する
- 強制削除を提案しない
git log <base>..<branch> で確認するよう案内する
すべての削除が完了したら結果を報告する:
✓ 2 件のローカルブランチを削除しました
削除済み: feature/add-login
削除済み: fix/typo-in-readme
スキップ: chore/update-deps（完全にマージされていないと報告されました）
ステップ 5: リモートブランチの削除（明示的に指示された場合のみ）
このステップはユーザーがリモートブランチの削除を明示的に要求した場合のみ実行する（例: 「リモートも削除して」「リモートも整理して」）。自発的に提案しない。
削除前にマージ済みのリモートブランチを確認する:
git branch -r --merged <remote>/<base-branch>
常に除外するもの:
<remote>/HEAD<remote>/main, <remote>/master, <remote>/develop, <remote>/staging, <remote>/release, <remote>/production
ステップ 3 と同様に候補を提示し、確認後に実行する:
git push <remote> --delete <branch>
すべての削除が完了したら、古いリモートトラッキング refs を整理する:
git fetch --prune
注意事項
-D は絶対に使用しない: git branch -d のみを使用する。強制削除はユーザーが手動で判断する事項である。- リモートの削除はオプトイン: 明示的な指示なしにリモートブランチの削除を提案したり、実行したりしない。
- 最初に
git fetch --prune を実行する: リモートですでに削除された refs をブランチ一覧から除外するために必要。
- 言語: スキルを呼び出したときにユーザーが使用した言語で常に応答する。
