メニュー
Use when マージ済みの不要ブランチを一括削除したいとき。「ブランチ整理」「マージ済み削除」「branch 掃除」「ブランチ一覧きれいにして」など、ブランチの整理に関わる場面で使用すること。 --dry-run で一覧提示だけ、--local / --remote / --worktrees / --merged-only / --include-no-pr で対象を絞れる。
デフォルトでは、最初にソースを確認する Prompt が選択されています。直接コマンドに切り替えるか、ローカルコピーをダウンロードすることもできます。
インストールを決める前に、SKILL.md と SkillsMP に表示されている付属ファイルをお読みください。
SOC 職業分類に基づく
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
直接コマンドでは確認用 Prompt が省略されます。実行前にソースを確認してください。
npx skills add https://github.com/daiki-beppu/dotfiles --skill clean-branchコマンドは1行のまま表示されます。コピー前に横へスクロールして全体を確認してください。
ローカルで確認しますか？SkillsMP が現在取得できるファイルをダウンロードできます。
SKILL.md を表示中
Manages stacked PRs and splits multi-part work into reviewable branches with gh-stack. Use for stack creation, viewing, edits, push, submit, sync, rebase, merge, or checkout; when asked to split or isolate work for review; whenever a user mentions a stack, branch layers, dependent PRs, or gh stack; or when a stack is checked out.
起票済みの GitHub issue を takt のタスクキューへ積み、cmux の別 pane で workflow を回して 完了まで見守る(workflow 判定 → 非対話で投入 → 検証 → pane で takt run → 完了検知)。 「takt に積んで」「takt task 追加」「#N を takt で回して」「タスクだけ積んでおいて」 「PR に積み増して」「takt 回して」など、takt へのタスク投入・実行を頼まれたときに使用すること。 投入は takt の内部 API を直呼びして対話ゼロで済ませ(branch / base / draft まで指定できる)、 stdout が数十万 token になる takt run だけを cmux の別 pane に逃がす。 PR のマージは対象外。issue が未起票なら issue スキルへ 委譲して起票してから積む(issue 無しで積む経路は用意しない)。 --run で run と完了検知まで、--dry-run で実行予定の提示まで、 --workflow / --branch / --base / --draft / --pr で選択を明示できる。
GitHub issue を直接実装する(段の列を決める → worktree 作成 → 段ごとに実装 → gh-stack で PR 作成 → CI green まで監視 → fix ループ)。 「issue #N を対応して」「親 issue #N をまとめて対応して」「PR作成とCI greenまで」など、issue の実装から PR 準備までを一気通貫で依頼されたときに使う。 親 issue を渡すと子 issue を依存順に段として積み、スタック全体が CI green になるまで走り切る。 追加のコードレビューやマージは対象外(CI green で完了)。
| name | clean-branch |
| description | Use when マージ済みの不要ブランチを一括削除したいとき。「ブランチ整理」「マージ済み削除」「branch 掃除」「ブランチ一覧きれいにして」など、ブランチの整理に関わる場面で使用すること。 --dry-run で一覧提示だけ、--local / --remote / --worktrees / --merged-only / --include-no-pr で対象を絞れる。 |
不要になったローカル・リモートブランチを検出し、一括削除する。
重要: マージ判定は git branch --merged ではなく PR の state を真実とする。GitHub が squash / rebase マージを使う場合、マージ済みブランチでも git branch --merged には現れない（tip コミットが main から到達不能なため）。--merged だけに頼ると squash マージ済みブランチを「未マージ＝作業中」と誤判定して取りこぼす。
git branch の一覧を整理したいとき--dry-run → Step 4 の分類別一覧までを出して停止する。何も削除しない。--local / --remote → 削除対象をローカルブランチのみ / リモートブランチのみに絞る。--worktrees → Step 3 だけを実行し、ブランチは 1 本も消さない。--merged-only → 削除対象を MERGED 分類だけに限定する。--include-no-pr → 既定では個別確認止まりの NO_PR も削除候補に含める。--local / --remote / --merged-only / --include-no-pr は併用できる。--dry-run は任意の変種への修飾子として働く。
git / gh 数回で終わる範囲であり、削除承認を取る主体を分けないgit fetch --prune --tags
# 全 PR を 1 回で取得（API 節約）
gh pr list --state all --limit 800 --json number,state,headRefName,mergedAt > /tmp/all_prs.json
# 対象ブランチ（local + remote, main/HEAD 除外）
{ git branch --format='%(refname:short)'
git branch -r --format='%(refname:short)' | sed 's#^origin/##'; } \
| grep -vE '^(origin/?|main|HEAD)$' | grep -v ' -> ' | sort -u > /tmp/branches.txt
各ブランチを headRefName で PR に紐づけ、state で分類する（MERGED > OPEN > CLOSED の優先で代表 state を採用）:
| 分類 | 意味 | 安全性 |
|---|---|---|
| MERGED | PR がマージ済み（squash 含む） | 安全（成果は main にある） |
| CLOSED | PR が未マージで close | 概ね安全（人間が意図的に close。GitHub PR ページから復元可） |
| OPEN | PR がオープン中 | 削除しない（レビュー中） |
| NO_PR | 紐づく PR が無い | 要個別調査（一度もレビューされていない。ローカルのみなら復元は reflog ~90日） |
--merged で「未マージ」に見えても実体はマージ済みのことが多い。NO_PR・CLOSED は誤削除を避けるため個別に確認:
# main より先行しているユニークコミットと最終更新日
git log --oneline main..<branch>
git log -1 --format='%ci %s' <branch>
# 紐づく issue の open/closed
gh issue view <N> --json state,title
git worktree list # prunable 表示と各ブランチの checkout 先を確認
git worktree prune -v # 実体ディレクトリが消えた登録（prunable）を掃除
git branch -d できない。先に git worktree remove <path> するgit worktree remove --force.claude/worktrees/ 配下は特に溜まる。 --worktree / EnterWorktree で作った worktree は cleanupPeriodDays の自動スイープ対象外（スイープされるのは subagent / background セッション由来のみ）。セッション終了時に「保持」を選ぶと、削除するまで永久に残る。
各 worktree が安全に消せるかは 3 点で判定する。すべて空なら失われる作業は無い:
git worktree list --porcelain | rg '^worktree ' | sed 's/^worktree //' | rg '\.claude/worktrees/' \
| while read -r w; do
echo "===== $w"
git -C "$w" status --porcelain --untracked-files=all # 未コミット変更・未追跡ファイル
git -C "$w" log --oneline main..HEAD # main に無いコミット
done
zsh では
for w in $(cmd)が単語分割されないため、上記のようにwhile read -rで受ける。
分類（MERGED / CLOSED / NO_PR）ごとに件数と一覧を提示し、スコープを確認してから削除する。リスクの低い MERGED と、復元しにくい NO_PR は分けて確認するとよい。
--local / --remote / --merged-only で対象を絞った場合も、分類（Step 1〜2）は全ブランチに対して行い、絞って外れた分は「対象外」として件数だけ一覧に添える。何が残っているかが見えないと、次に何を消すべきか判断できないため。
# ローカル: MERGED でも squash の場合 -d は「未マージ」と拒否するため -D を使う
git branch -D <branch>
# リモート: 複数を 1 コマンドで一括削除できる
git push origin --delete <branch1> <branch2> <branch3> ...
削除した件数・分類別内訳を表示し、復元方法を添える:
git reflog から約 90 日間（削除時 SHA はログに残る）git branch --merged は squash マージを取りこぼすため補助的にしか使わない）--include-no-pr を付けても Step 2 の確認は省略しない--local / --remote / --merged-only / --include-no-pr / --worktrees）はこの承認を免除しないgit worktree remove してから削除するgit branch -d が拒否する: squash マージ済みブランチは未マージ扱いなので -d が失敗する。PR state で MERGED 確認済みなら -D で削除してよいmapfile は使えない（bash 専用）。配列は arr=("${(@f)$(cmd)}") で行分割、要素は "${arr[@]}" で展開。for x in $var は zsh では単語分割されない（"${(@f)var}" か配列を使う）git push origin --delete b1 b2 b3 と複数 ref をまとめて渡せる（push 回数を減らせる）