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 链接至该分支，确保您可以快速恢复先前的任务工作。