squash-unit スキル

Unit完了時またはInception Phase完了時の中間コミットを1つの完了コミットにまとめる。

引数解決手順

スキル呼び出し時、以下の引数をAIが自動解決する。引数が直接指定されている場合はそちらを優先する。

引数	解決方法	例
--cycle	ブランチ名から抽出（cycle/ プレフィックス除去）	v1.20.0, waf/v1.0.0
--unit	現在作業中のUnit番号（3桁ゼロ埋め）。Inception Phase完了squashでは省略する	003
--vcs	常に git を指定	git
--base	コミット履歴からUnit開始コミットの直前を特定（後述）	cdbf67ab
--message / --message-file	mktemp /tmp/aidlc-squash-msg.XXXXXX でパス生成 → Writeツールで書き込み → --message-file で渡す	/tmp/aidlc-squash-msg.XXXXXX

ブランチ名からの --cycle 解決

git branch --show-current

出力が cycle/v1.20.0 の場合: --cycle 'v1.20.0' 出力が cycle/waf/v1.0.0 の場合: --cycle 'waf/v1.0.0'

起点コミット（--base）の特定

コミット履歴を遡り、以下のいずれかのパターンにマッチする最新コミットを特定する:

• 直前のUnit完了コミット: feat: [{{CYCLE}}] Unit {NNN-1}完了 -
• Inception Phase完了コミット: feat: [{{CYCLE}}] Inception Phase完了 -
• サイクルブランチの起点: cycle/{{CYCLE}} ブランチの分岐元

特定したコミットのハッシュを --base に渡す。

実行フロー

1. dry-run で対象コミット確認

Unit完了squashの場合:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' --unit '{NNN}' \
  --vcs git --base '<起点コミット>' --dry-run

Inception Phase完了squashの場合（--unit 省略）:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' \
  --vcs git --base '<起点コミット>' --dry-run

出力例:

target_count:3
squash:dry-run:3

2. 続行確認

dry-run結果をユーザーに提示し、続行を確認する。

3. メッセージファイル作成

Bashツールで mktemp /tmp/aidlc-squash-msg.XXXXXX を実行してパスを生成し、Writeツールで生成されたパスに書き込む:

Unit完了squashの場合:

feat: [{{CYCLE}}] Unit {NNN}完了 - {UNIT_NAME}

Unit-Number: {NNN}

Inception Phase完了squashの場合:

feat: [{{CYCLE}}] Inception Phase完了 - {DESCRIPTION}

4. squash実行

Unit完了squashの場合:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' --unit '{NNN}' \
  --vcs git --base '<起点コミット>' --message-file <生成されたパス>

Inception Phase完了squashの場合（--unit 省略）:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' \
  --vcs git --base '<起点コミット>' --message-file <生成されたパス>

5. 一時ファイル削除・結果確認

一時ファイルを削除し、出力を確認:

• squash:success:<hash>: squash完了
• squash:skipped:no-commits: 対象コミットなし（通常コミットへ進む）
• squash:error:<type>: エラー発生（エラーハンドリング参照）

retroactive モード

過去のUnitを事後squashする場合:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' --unit '{NNN}' \
  --vcs git --retroactive --message-file <生成されたパス>

--from / --to でUnit開始・終了コミットを明示的に指定することも可能:

docs/aidlc/bin/squash-unit.sh --cycle '{{CYCLE}}' --unit '{NNN}' \
  --vcs git --retroactive --from '<開始コミット>' --to '<終了コミット>' \
  --message-file <生成されたパス>

エラーハンドリング

出力パターン	対応
squash:success:<hash>	正常完了。新しいコミットハッシュを記録
squash:skipped:no-commits	「squash対象のコミットがありません」と表示。通常コミットへ進む
squash:error:dirty-working-tree	未コミットの変更あり。コミットまたはstashしてから再実行
squash:error:base-not-found	起点コミットが見つからない。手動で --base を指定
squash:error:*	エラーメッセージとrecoveryコマンドをユーザーに提示

エラー解消が困難な場合は、commit-flow.md の手動squashフロー（Squash統合フローセクション）を案内する。

注意事項

• 各引数は必ず引用符で囲む（特に --cycle と --base）
• コマンド内に $() を使用しない（AIが値を事前に解決してから組み立てる）
• --message-file を使用し、--message でのコマンドライン直接埋め込みは避ける