| name | commit-diffs |
| description | 現在の差分を分析し、最適な粒度でコミットを分割・実行する。
Git / GitButler CLI 両環境に対応。
単純なケースはスキル内で完結、複雑なケースはcommit-managerサブエージェントへ委譲。
|
Commit Diffs Expert
核心原則: 1コミット＝1つの論理的変更。原子性・レビュー容易性・履歴可読性を最大化する。
Step 0: 環境検出
最初に実行環境を判定する。以降のステップでは判定結果に応じたコマンドを使う。
git branch --show-current
| 結果 | 環境 | 表記 |
|---|
gitbutler/workspace | GitButler | 🅱️ |
| それ以外 | Git | 🅶 |
補足: GitButler 環境では but コマンドで並列ブランチ・ファイル指定コミットが使える。
Git の読み取り系コマンド（git log, git blame 等）は両環境で使用可能。
判断基準: スキル vs サブエージェント
IF 単純なケース（以下すべて該当）:
├─ 変更ファイル: 3つ以下
├─ カテゴリ: 単一（feat/fix/refactorなど）
├─ 依存関係: なし（各変更が独立）
└─ → スキル内で完結（下記クイックフローに従う）
IF 複雑なケース（以下いずれか該当）:
├─ 変更ファイル: 4つ以上
├─ カテゴリ: 複数混在（feat + refactor など）
├─ 依存関係: あり（変更間に順序依存）
├─ 50行以上の大規模差分
└─ → commit-manager サブエージェントを起動
クイックフロー（単純なケース）
flowchart LR
A[環境検出] --> B[差分取得]
B --> C[分類判定]
C --> D{複雑?}
D -->|Yes| E[サブエージェント起動]
D -->|No| F[コミット実行]
F --> G[完了確認]
Step 1: 差分取得と判定
🅶 Git 環境:
git diff --stat
git diff
🅱️ GitButler 環境:
but status -f
but diff
GitButler Tips: but status -f でファイルごとの CLI ID（例: h0, i0）が表示される。
この ID は Step 3 のファイル指定コミットで使う。
判定:
| 状態 | 判断 | アクション |
|---|
| 変更なし | 終了 | 「コミット対象の変更がありません」と報告 |
| 4ファイル以上 | 複雑 | サブエージェント起動 |
| 複数カテゴリ混在 | 複雑 | サブエージェント起動 |
| 単純 | 続行 | Step 2へ |
Step 2: カテゴリ特定
classification.md を参照し、変更のカテゴリを特定する。
Step 3: コミット実行
🅶 Git 環境:
git add <対象ファイル>
git commit -m "$(cat <<'EOF'
[カテゴリ]: 概要
本文（何を/なぜ変えたか）
EOF
)"
🅱️ GitButler 環境:
but commit -m "$(cat <<'EOF'
[カテゴリ]: 概要
本文（何を/なぜ変えたか）
EOF
)" <branch>
but commit -p <file-id1>,<file-id2> -m "$(cat <<'EOF'
[カテゴリ]: 概要
本文（何を/なぜ変えたか）
EOF
)" <branch>
GitButler Tips:
but commit -p h0,i0 -m "msg" <branch> でファイル単位の選択コミットが可能（git add -p 不要）- ブランチを指定しない場合、変更が割り当てられているブランチへコミットされる
- 異なるカテゴリの変更を別々のブランチへ同時にコミットできる
Step 4: 完了確認
🅶 Git 環境:
コミット完了:
- カテゴリ: [カテゴリ]
- 概要: [概要]
- ファイル: [対象ファイル]
- コミットハッシュ: [hash]
🅱️ GitButler 環境:
コミット完了:
- カテゴリ: [カテゴリ]
- 概要: [概要]
- ファイル: [対象ファイル]
- ブランチ: [branch名]
- コミットID: [but status で確認]
GitButler Tips: コミット後に but status でブランチ状態を確認。
誤ったコミットは but rub <commit-id> 00 で取り消せる（but undo でも可）。
サブエージェント起動テンプレート
複雑なケースでは以下のプロンプトで commit-manager サブエージェントを起動:
【タスク】
差分を分析し、最適な粒度でコミットを分割・実行
【環境】
{Git or GitButler}
【現在の差分】
{🅶 git diff --stat / 🅱️ but status -f の結果}
【期待する出力】
- 変更の分類と依存関係の特定
- Multi-Aspect Scoringによる分割評価
- 最適なコミット計画の作成と実行
GitButler 環境での補足: サブエージェントには以下も伝える:
but status -f の出力（ブランチ構造と CLI ID）- 対象ブランチ名
but commit -p によるファイル指定コミットが使えることbut rub によるコミット間の変更移動が使えること
詳細参照
