using-git-worktrees skill 是什麼、怎麼用：Superpowers 讓智能體在隔離工作區裏開發的 Skill

本文根據 obra/superpowers 倉庫裏該技能的 SKILL.md 與倉庫 README 整理，資料核對於 2026-10-11。skills.sh 榜單當日顯示該技能累計安裝約 20.6 萬次；所在倉庫 obra/superpowers 在 GitHub 約 29.7 萬 Star（同日數據）。技能內容會隨倉庫更新，以倉庫為準。

這個 Skill 做什麼

讓智能體直接在你正在用的工作目錄裏大改代碼，風險是它的半成品和你手頭的改動攪在一起。using-git-worktrees 確保工作發生在隔離的工作區裏。description：開始需要與當前工作區隔離的功能開發時，或執行實施計劃之前使用——通過原生工具或回退到 git worktree 的方式，確保存在一個隔離的工作區。

它的核心原則有先後順序：先檢測是否已經隔離，再用原生工具，最後才回退到手動 git，並且「永遠不要和宿主工具對着幹」。具體步驟：

• 第 0 步，檢測：通過比較 git 目錄判斷當前是否已經在某個 worktree 裏；說明裏特意提醒，在 git 子模組裏這個判斷也會為真，要先排除。
• 第 1 步，創建：所用工具自帶 worktree 功能就用它的；沒有才手動執行 git worktree 命令。目錄位置優先沿用項目裏已有的 .worktrees/，沒有其他約定時預設建在項目根目錄的 .worktrees/ 下，並先確認該目錄已被 git 忽略，沒有就加進 .gitignore 並提交。
• 第 2 步，項目準備：按項目類型安裝依賴。
• 第 3 步，驗證基線：跑一遍測試，確認動手之前是綠的，這樣之後出現的失敗才能歸因到新改動。

怎麼安裝

using-git-worktrees 是 Superpowers 插件裏的一個技能，不單獨發佈：作者的設計是整套一起安裝，由會話開始時注入的引導指令決定各技能何時觸發。Claude Code 裏輸入（命令來自倉庫 README）：

text
/plugin install superpowers@claude-plugins-official

Codex 在 /plugins 裏搜尋 superpowers 安裝；Gemini CLI 用 gemini extensions install https://github.com/obra/superpowers。裝好後在命令選單裏以 /superpowers:using-git-worktrees 的形式出現，也會按場景自動觸發。

倉庫整體介紹和其他安裝方式，詳見本站《Superpowers 是什麼、怎麼安裝和使用：Claude Code / Codex 最熱門的 Skills 開發流程框架》。

怎麼用

• 在 Superpowers 流程裏，設計確認後它會自動觸發，並先聲明正在用這個技能建立隔離工作區。
• 單獨使用：「給支付重構開一個 worktree，裝好依賴並跑一遍測試」。
• 工作結束後的合併與清理由 finishing-a-development-branch 負責。

這個技能只有一份 SKILL.md。

適合誰 / 侷限

適合同時推進多件事、或想讓智能體放手改又不影響主目錄的開發者。worktree 會多佔一份依賴安裝的磁盤和時間；依賴很重的項目（大型前端、需要本地數據庫的服務）每開一個都要重新準備環境；不使用 git 的項目無法使用。

注意事項

• 許可：MIT。
• 會執行 git 與安裝命令，可能修改並提交 .gitignore。
• 基線測試本來就不通過時，它會報告並詢問，而不是默默繼續。