kompiro Sync Worktrees Skill
進行中の worktree（.claude/worktrees/<branch> など）に、マージ済みの最新
default ブランチ（通常 main）を merge で取り込む。複数の worktree を
並行で走らせていて、どれかの PR が main に入った後に残りを一括で追従させる
ためのもの。
- merge であって rebase ではない。worktree のブランチは PR として公開されて いる前提なので、履歴を書き換える rebase ではなく merge で取り込む。
- push はしない。ローカル merge までで止める。push は pre-push hook / CI を
発火させるため、各 worktree での
pnpm i済み確認も含めてユーザーの判断に委ねる。 - 自動コンフリクト解決はしない。衝突したらその worktree で止めて報告する。
前提条件
- 対象リポジトリ内（いずれかの worktree、または main 本体）で実行されていること。
- リモート追跡が設定されていること（
origin）。
手順
1. default ブランチを特定して fetch する
- default ブランチ名を自動検出する:
git rev-parse --abbrev-ref origin/HEAD（例:origin/main→main）。 取得できなければmain、無ければmasterにフォールバックする。 - 最新を取得する:
git fetch origin <default>。- 以降この
origin/<default>を取り込み元として使う。
- 以降この
2. 対象 worktree を列挙する
git worktree list --porcelainで全 worktree を取得する。- 各エントリについて、次を 対象から除外 する:
bareの worktree。detached（detached HEAD）の worktree — 追従先ブランチが無いため。- ブランチが default ブランチそのものの worktree（main 本体は取り込み元なので対象外）。
- 残った「feature ブランチを持つ worktree」が対象。
- 引数でブランチ名 / worktree パスが渡された場合は、その 1 つだけに絞る
（例:
/hane:sync-worktrees feat/key-generator）。
3. 各対象 worktree を順に処理する
各 worktree のパスを <wt> として、cd せず git -C <wt> ... で操作する。
作業中・未コミットの保護（skip 判定）。次のいずれかに当たる worktree は merge せずスキップし、理由を控える:
- 未コミットの変更がある:
git -C <wt> status --porcelainが非空。 - 既に merge / rebase / cherry-pick が進行中:
<wt>の git dir にMERGE_HEAD/REBASE_HEAD等がある（git -C <wt> statusで "You have unmerged paths" 等が出る）。
これは他のセッションがその worktree で作業中の可能性に配慮した保護でもある （後述「並行作業との関係」）。
- 未コミットの変更がある:
既に最新なら skip。
git -C <wt> merge-base --is-ancestor origin/<default> HEADが真なら、その worktree は既に default を含んでいるので "up-to-date" として スキップする。merge を実行:
git -C <wt> merge --no-edit origin/<default>。- 成功 → "updated" として控える。
- コンフリクト（終了コード非 0、
git -C <wt> diff --name-only --diff-filter=Uが非空）→ "conflict" として控え、衝突ファイル一覧を報告する。 merge はその場に残したまま次の worktree へ進む（勝手に abort しない）。 ユーザーには次の 2 択を伝える:- その worktree で手で解決してコミットする、または
git -C <wt> merge --abortで取り込みを取り消す。
4. サマリを返す
処理後、件数を集計して報告する:
- updated: main を取り込んだ worktree（パスとブランチ名）。
- conflict: 衝突した worktree（衝突ファイルと、解決 / abort の案内）。
- skipped (dirty / in progress): 未コミット・merge 進行中でスキップした worktree。
- up-to-date: 既に最新だった worktree。
push していないことを明記し、各 worktree の push（→ PR 更新・CI 発火）は ユーザー判断であることを添える。
並行作業との関係
git の worktree は index・HEAD・作業ツリーがそれぞれ独立しており、worktree A の
ブランチへ merge しても worktree B には影響しない。git は worktree ごとに
index.lock で操作を直列化するので、データ破損の意味では安全に同時実行できる。
問題になるのは 取り込み先の worktree を別セッションが今まさに編集している 場合だけ。merge はその worktree の作業ファイルを書き換えるため、相手の編集と 競合し得る。本 skill は次でこれを緩和する:
- 未コミット変更がある worktree は skip（手順 3-1）。作業中セッションの多くは 未コミットの編集を抱えているため、これで実害のあるケースの大半を外せる。
- 残る隙は「作業ツリーが clean なまま別セッションが次の編集に入ろうとしている」 瞬間のみ。気になる場合は引数で対象 worktree を 1 つに絞るか、対象から外す。