create-worktree

create-worktree 技能是一款專為開發人員設計的工程生產力工具，適用於需要在單一儲存庫中同時管理多個功能分支的情境。透過利用 git worktree 功能，此技能允許使用者在無需頻繁切換分支或重新安裝相依套件的情況下，維護多個隔離的開發環境。它特別適合處理複雜專案的開發人員，例如同時涉及前端、後端與 Agent 服務，且環境變數管理至關重要的應用場景。

當觸發此技能時，它會自動在 .worktrees/ 目錄下建立新的子目錄，初始化新的功能分支，複製必要的環境設定檔（例如 .env, .envrc 以及各模組專屬的設定檔），並執行 make setup 以準備本機開發環境。這消除了手動設定的繁瑣，並確保了不同功能開發流程之間的一致性。

• 自動建立隔離的 git worktree，以實現快速的環境切換與並行任務執行。

• 自動複製核心環境檔案，包括 .env, .envrc 以及針對前後端模組的各類變體設定檔。

• 與本機開發流程無縫整合，支援在初始化時自動觸發 make setup 指令。

• 作為基於 Shell 的工具運作，確保與任何 git 管理的儲存庫結構皆具備相容性。

• 可與 pr-and-cleanup 技能搭配使用，實現從初始化到提交 Pull Request 的全生命週期管理。

• 執行環境必須已安裝 git，且儲存庫需為合法的 git 專案。

• 最適合採用標準化環境檔案命名慣例的開發者或團隊，以確保配置變數的自動同步。

• 建議搭配 .claude/settings.json 設定使用，以便在計畫階段結束後自動提示開發者執行此工具。

• 雖然該工具處理了配置的初始化與同步，但它並不管理外部雲端機密，請確保本機檔案的處理符合您的儲存庫安全政策。

• 若分支已存在，腳本會自動將 worktree 連結至該分支，確保您可以快速恢復先前的任務工作。