菜单
マージ済みのローカル・リモートブランチを整理するスキル。「ブランチ掃除」「マージ済みブランチを削除」「ブランチ整理」「gh poiを実行」「不要なブランチを片付けて」「リモートのブランチも消したい」「mainだけ残して」のような依頼で必ず使う。gh-poi拡張がインストール済みであることを前提とする。mainなどベースブランチは絶対に削除しない。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Gitコミットを適切な粒度に分割し、有用なメッセージを付けて作成するスキル。「コミットして」「commitして」「変更をコミット」「まとめてコミット」など、コミット操作を依頼されたら必ず使う。
指定したスキルを3回繰り返し適用します。レビュー・計画・実装など、ファイルを変更するスキルに使います。「iterateで<スキル名>して」「<スキル名>を繰り返し適用して」のように使います。
既存テストをレビューして改善するスキル。「テストをレビューして」「テストを改善して」「テスト名を直して」のように頼まれたら使う。新規にテストを書くのではなく、`.claude/docs/test-implementation.md` のルール（テスト名・AAA構造・アサーション設計・テストダブル・非決定性制御・テスト間独立性・Testing Library 等のフロントエンド固有ルールまで全観点）に既存テストが沿っているかを見直す。対象は `.test.ts` / `.test.tsx` / `.spec.ts` ファイルと、テストコードブロックを含む `.md` ドキュメントファイル。
作った成果物について、ユーザーがその振る舞いと目的を確実に理解できているかを問いかけで確認します。細かな実装ではなく、何をするものか・目的にかなうかに焦点を当て、あらゆる可能性を踏まえてエージェントが判断して問いを立てます。「理解できているか確認して」「振る舞いを確認して」「目的にかなっているか見て」「作ったあとのすり合わせをして」と要望された際に必ず使用します。実装や変更が一段落したとき、作ったものの理解をすり合わせたいと感じたら積極的に提案してください。
`/compact`で要約する前に、残したい情報をユーザーに選んでもらい`/compact`の引数を組み立てます。 「compact前に整理したい」「コンテキストを圧縮したい」「/compactの引数を作って」 「会話が長くなってきたので整理したい」「重要な情報を引き継ぎたい」のように使います。
大きな計画や実装タスクを、依存関係順に並んだ最小単位のステップに分解します。各ステップは単独でレビュー・コミットできる粒度にします。「分解して」「ステップに割って」「細かく割り当てたい」「着手前に整理したい」「段階的に進めたい」「タスクを整理して」と要望された際に使用します。
| name | x-cleanup-merged-branches |
| description | マージ済みのローカル・リモートブランチを整理するスキル。「ブランチ掃除」「マージ済みブランチを削除」「ブランチ整理」「gh poiを実行」「不要なブランチを片付けて」「リモートのブランチも消したい」「mainだけ残して」のような依頼で必ず使う。gh-poi拡張がインストール済みであることを前提とする。mainなどベースブランチは絶対に削除しない。 |
| allowed-tools | ["Bash","Read","AskUserQuestion","TaskCreate","TaskUpdate","TaskList"] |
ローカルとリモートの両方で、ベースブランチと「保持対象」（マージされていない作業中のもの）以外のブランチが削除された状態です。途中で止めず、最後に必ず削除前後のブランチ数をユーザーに報告します。
seachicken/gh-poi拡張をインストール済みであることを前提とします。インストールされていない場合はユーザーにgh extension install seachicken/gh-poiの実行を依頼してから続行します。
前提確認とベースラインカウント→ベースブランチ確定→ベースブランチ最新化とfetch --prune→ローカル整理（gh poi）→ローカル取りこぼし回収→リモート削除候補抽出→ユーザー確認→リモート削除→完了報告
フローを開始する前に、全ステップをTaskCreateで登録します。各ステップを開始するときTaskUpdateでin_progressへ、完了したときcompletedへ更新します。
| # | subject | blockedBy |
|---|---|---|
| 1 | Step 0: 前提確認とベースラインを取得する | — |
| 2 | Step 1: ベースブランチを確定する | 1 |
| 3 | Step 2: ベースブランチへ切替して最新化する | 2 |
| 4 | Step 3: ローカルブランチをgh poiで整理する | 3 |
| 5 | Step 4: gh poiが拾えなかったローカルブランチを処理する | 4 |
| 6 | Step 5: リモートブランチの削除候補を抽出する | 5 |
| 7 | Step 6: 削除候補をユーザー確認してから一括削除する | 6 |
| 8 | Step 7: 完了報告 | 7 |
まずgh poi --helpを実行し、コマンドが応答するかを確認します。応答しなければ中断してユーザーにインストールを依頼します。
続けてベースラインのブランチ数を記録します。Step 7の差分報告に使うので、変数として保持しておきます。
gh poi --help
BEFORE_LOCAL=$(git branch --list | wc -l | tr -d ' ')
BEFORE_REMOTE=$(git ls-remote --heads origin | wc -l | tr -d ' ')
git symbolic-ref refs/remotes/origin/HEADでリモートのデフォルトブランチを取得します。取得できない、またはmain以外が返った場合はユーザーに確認します。
確認した結果は以降の手順で<BASE>として扱います（多くの場合はmain）。
git checkout <BASE>
git pull origin <BASE>
git fetch --prune origin
fetch --pruneは必須です。リモート側ですでに削除されたブランチのorigin/<branch>参照がローカルに残っていると、Step 5の--is-ancestor判定が古いコミットを見てしまい、削除判定が壊れます。
切替に失敗する場合（コミットしていない変更がある等）は止めてユーザーに対処を依頼します。勝手にstashや強制切替はしません。
まずgh poi --dry-runで削除対象を表示します。出力を要約してユーザーに提示し、削除対象が想定通りかを目視確認してもらいます。承認を得たらgh poiを実行します。
gh poiは「PRがマージされた（squash/rebase mergeを含む）ブランチ」を削除対象にします。PRなしで通常マージコミットで取り込まれたブランチはここでは残るので、Step 4で回収します。
git branch --merged <BASE>で<BASE>の祖先になっているブランチを取得し、<BASE>自身を除いた一覧を削除候補とします。
git branch --merged <BASE> | grep -v "^[* ] <BASE>$" | xargs -n1 git branch -d
-Dは使わず、-dの安全モードを維持します。-dは祖先関係を満たさないブランチの削除を拒否するため、想定外の削除を防げます。
git ls-remote --heads originでリモートブランチ一覧を取得し、<BASE>以外の各ブランチについて2軸で判定します。
| 軸 | 判定方法 |
|---|---|
| PR状態 | gh pr list --state all --limit 1000 --json number,state,headRefNameを1回だけ叩き、結果をheadRefNameでマップ化してから、各ブランチのPRstateを引き当てる |
| 祖先関係 | git merge-base --is-ancestor origin/<branch> origin/<BASE> |
gh pr listの取得件数が1000ちょうどだった場合は、PR一覧を取りきれていない可能性があるので警告して中断します。古いMERGED PRがマップから漏れると、squash mergeされたブランチが祖先関係でも検出できず「削除されない」に倒れて取りこぼします。
削除条件は次の通りです。
MERGEDのブランチ、もしくは<BASE>の祖先になっているブランチ（PRなしでも内容が取り込み済みの場合）を削除対象にしますOPENまたはDRAFTのブランチ、もしくは祖先ではなくPRもないブランチは削除しません削除候補を「ブランチ名（削除理由）」の形でユーザーに提示し、承認を得ます。承認後、git push origin --deleteの1回の呼び出しに全候補を並べて一括削除します。--porcelainを付けることで、ブランチごとの成功・失敗を機械的にパースできます。
git push --porcelain origin --delete <branch1> <branch2> <branch3> ...
git pushはrefspecごとに個別評価されるため、部分失敗が起こり得ます（権限不足・ブランチ保護・すでに削除済みなど）。--porcelainの出力から成功したブランチと失敗したブランチを分けて、最終報告に含めます。
Step 0で記録したBEFORE_LOCAL・BEFORE_REMOTEと、削除後の値を比較します。
AFTER_LOCAL=$(git branch --list | wc -l | tr -d ' ')
AFTER_REMOTE=$(git ls-remote --heads origin | wc -l | tr -d ' ')
以下を簡潔に報告します。
<BASE>以外で残っているものがあればその理由を添えます「PRがない」「PRがOPEN」「ロックされている」のいずれかが理由です。Step 4で<BASE>の祖先になっているブランチを拾うので、PRがないだけのブランチは自動的に削除されます。OPEN PRがあるブランチは作業中なので削除しません。
git push --porcelain origin --deleteの出力に!や[remote rejected]が出た場合は、ブランチ保護設定（GitHub側）または権限不足が原因です。--porcelain出力をそのままユーザーに見せて、判断を委ねます。
main以外（master/develop等）の場合Step 1で確認した<BASE>を最後まで一貫して使います。origin/HEADのシンボリックリンクが古い場合はgit remote set-head origin --autoで更新してから再取得します。