Using Git Worktrees Skill

Using Git Worktrees は Superpowers のスキルです（スキルのソース）。機能開発を現在のチェックアウトから切り離す必要があるとき、通常は設計の承認後、計画の実行前に動き、エージェントが専用のブランチの別ワークスペースで、クリーンなテストの基準線から作業できるようにします。

原則は「まず既存の隔離を検出し、次にネイティブのツールを使い、最後に git に頼る。ツールと争わない」です。

主な機能

• ステップ 0、検出：git rev-parse --git-dir と --git-common-dir を比べて、すでにリンクされた worktree にいるか判定。git のサブモジュールを worktree と誤認しないガード付き。
• 同意：指示に好みが書かれていなければ、worktree を作る前に確認し、断られたらその場で作業。
• ネイティブ優先：ツールに独自の worktree 機能（/worktree コマンドや EnterWorktree のようなツール）があればそれを使う。手動の worktree はツールから見えない状態を作るため。
• git へのフォールバック：それ以外は .worktrees/（推奨）か worktrees/ で git worktree add <path> -b <branch>。事前に git check-ignore でディレクトリが無視対象か確認。
• セットアップと基準線：npm install、cargo build、pip install、poetry install、go mod download を自動判定し、テストを実行して基準線を報告。
• サンドボックス時のフォールバック：サンドボックスが worktree の作成を拒否したら、そう伝えて現在のディレクトリで作業。

使用シナリオ

• メインのチェックアウトに触れずに機能開発を始める。
• 一つのリポジトリの別々のブランチで複数のエージェントを動かす。
• Executing Plans や Subagent-Driven Development の前。

料金

MIT ライセンスの無料オープンソースです。Superpowers を開発する Prime Radiant は企業向けに商用サポートを提供しています。実質的なコストはトークンで、プロセス系スキルは質問、レビュー、サブエージェントの実行を増やします。

はじめに

Superpowers は一つのプラグインとしてインストールされ、このスキルはライブラリ全体（v6.4.1 で 15 スキル）と一緒に入ります。Claude Code では /plugin install superpowers@claude-plugins-official。Cursor は /add-plugin superpowers、Gemini CLI は gemini extensions install https://github.com/obra/superpowers。Codex、GitHub Copilot CLI、OpenCode、Pi などのコマンドは README にあります。スキルは自動で起動し、名前を指定して呼び出すこともできます。 ワークフロー系スキルが呼び出しますが、「この機能用に隔離された worktree を作って」と頼むこともできます。

制約：worktree ごとに依存関係のインストールが必要で、大きなプロジェクトではディスクと時間を消費します。後片付けは Finishing a Development Branch の担当です。

よくある質問

なぜ作成前に確認するのですか？

ファイルシステムの構成が変わるため、好みが示されていない限りあなたの判断に委ねています。

基準線のテストが失敗したら？

エージェントは失敗を報告し、続行するか尋ねます。

代替案

• Conductor：隔離したコピーで複数の Claude Code を並列実行する Mac アプリ。
• Orca ADE：複数のコーディングエージェントを worktree で並べて動かす。
• cmux：多数のエージェントセッションを扱うためのターミナル。

まとめ

小さく慎重で、使うツールに配慮したスキルです。エージェントの作業をメインブランチから遠ざけます。詳しくは skills カテゴリ へ。