| name | git-squash |
| description | 現在のbranchのcommitを自動でsquash・整理し、必要に応じてforce-with-leaseでpushするSkill。言語指定可能。ユーザーが「commitをsquashして」「commitを整理して」のように依頼したら使うこと。 |
| allowed-tools | Bash(git:*), Bash(gh:*), Bash(jq:*), Bash(cat:*), Bash(grep:*), Bash(rg:*) |
Squash Commits
現在のbranchのcommitを、対話を最小化して整理する。
未指定時は論理単位で自動グルーピングし、--one / -1 指定時のみ全commitを1つにまとめる。
Arguments
language: commitメッセージと報告の言語（例: "ja", "en"）。デフォルト: English--one / -1: 対象commitを1つにsquashする--no-push: squash後にpushしない--dry-run: squash計画（グルーピング案と新しいcommitメッセージ案）のみを提示し、reset・commit・pushを一切行わない
タスク
-
事前チェック:
- 現在のbranch、base branch、対象commit数、作業ツリー状態、upstreamとの差分を確認する
- default branch上では実行せず中止する
- 対象commitが0件なら中止する。1件のみならsquash不要として終了する
- 未commit変更がある場合は中止する。stashやcommitは自動実行しない
- upstream側に未取得commitがある場合は中止する。履歴消失を避けるため、自動で上書きしない
-
出力言語の決定:
language 指定があれば従う- 指定がなければPRタイトル・本文、または直近commitの言語から判定する
- 曖昧な場合はEnglishをデフォルトにする
-
squash方針の決定:
--one / -1 指定時は全commitを1つにまとめる- 指定がない場合は、commitのtype、変更ファイル、PR文脈を見て論理単位に自動グルーピングする
- グループ分離が不安定な場合は、1つにまとめる方へフォールバックする
-
commitメッセージの生成:
- 変更内容から自動生成する
- Conventional Commits形式に従う
- 2行目は必ず空行にする
- 3行目以降に具体的な変更内容を箇条書きで記述する
--dry-run が指定された場合は、ここまでのグルーピング案と新しいcommitメッセージ案のみを提示し、reset・commit・pushを一切行わず終了する。
-
squashの実行:
git reset --soft origin/<base-branch> で対象commitを解除する--one の場合は全変更を1つのcommitとして作成する- 自動グルーピングの場合は、グループごとに関連ファイルをstageしてcommitする
- 同一ファイルの変更が複数グループに混在し、
git add -p でも安全に分離できない場合は、1つのcommitへフォールバックする
-
push:
--no-push 指定時はpushせず、必要なコマンドを報告する- それ以外は
git push --force-with-lease を自動実行する
--force-with-lease が失敗した場合は中止し、--force へフォールバックしない
-
結果の表示:
注意事項
- ユーザー確認は原則行わない。危険な状態は自動判断で中止し、理由を報告する
git push --force-with-lease のみ使用し、git push --force は使用しない- squash中にconflictが発生した場合は
git-fix-conflict Skill を使って解消する。本Skillの主手順（reset --soft主体）ではconflictは発生しない設計であり、万一発生した場合のみ委譲する
