Git Worktree 并行环境创建技能
一句话创建端口、数据库、配置完全隔离的 git worktree，让多个分支环境同时运行互不干扰。
创建隔离 git worktree（含独立端口/数据库配置）的技能，明确限定「只在用户明确要求用 skill 创建 worktree 时才触发」，避免误触发。
这个 Skill 能做什么，适合哪些场景？
这是 disler/claude-code-hooks-multi-agent-observability 仓库捆绑的四个技能之一，位于 .claude/skills/create-worktree-skill/。它本身是一个薄封装：由 Claude Code 的 SlashCommand 工具调用仓库自带的 /create_worktree_prompt 斜杠命令，在 trees/<分支名> 下创建 git worktree，自动分配不冲突的端口、配置环境文件、安装依赖并启动服务。该技能明确限定了触发条件：只有用户明确说“用技能创建 worktree”时才应被调用，避免误触发。它依赖仓库中配套的斜杠命令与 bun 运行时，离开该仓库的 .claude 目录无法独立工作。
从用户请求中提取必填的分支名和可选的端口偏移量；通过 SlashCommand 工具运行 /create_worktree_prompt <分支名> [端口偏移]；该命令在 trees/<分支名> 创建 git worktree，自动递增分配端口避免冲突，写入环境配置文件，为 server 和 client 安装依赖，并自动启动两个服务；最后向用户返回访问 URL、所用端口及停止/重启/删除 worktree 的操作说明。未提供分支名时会停下来向用户询问。
- 开发者想在 feature-dashboard 分支上开一个独立环境而不打断当前工作区
- 团队需要同时运行 feature-a、feature-b、feature-c 三个分支的服务做对比测试
- 修 hotfix-security 时希望并行环境使用指定的端口偏移（如 5）避免端口冲突
- 需要为多个分支各建一套隔离的测试环境（独立端口、数据库、配置）
- 用户明确要求“用技能/斜杠命令的方式创建 worktree”
这个 Skill 有哪些优点和局限？
- 一条命令完成 worktree 创建、端口分配、环境配置、依赖安装和服务启动的全流程
- 多 worktree 并行时端口自动递增错开，避免手动管理冲突
- SKILL.md 明确限定触发条件，降低误触发风险
- 附带常见故障（端口占用、分支冲突、缺 bun）的排查指引
- 强依赖 Claude Code 的 SlashCommand 工具和仓库自带的 /create_worktree_prompt 命令，无法脱离该 .claude 目录独立使用
- 隐式要求安装 bun，其他包管理器未提及支持
- 属于四技能捆绑仓库的一员，README 主要描述可观测性系统，本技能自身缺少独立文档与测试证据
- 许可证未在源中注明，商用前需自行确认
如何安装这个 Skill？
将仓库的 .claude 目录整体复制到项目根目录：cp -R .claude /path/to/your/project/。技能位于 .claude/skills/create-worktree-skill/，它依赖同仓库 .claude/commands/ 下的 /create_worktree_prompt 命令，二者需一起部署。需安装 bun（依赖安装使用）。许可证信息未在源中说明。
如何使用这个 Skill？
在 Claude Code 中明确要求调用技能，例如：'use a skill to create a worktree for feature-auth'（不提 skill 则不会触发）。带端口偏移的例子：'invoke the worktree skill on hotfix-security with port offset 5'。也可同时为多个分支创建：feature-a、feature-b、feature-c 各执行一次，端口自动错开（如 4010/5183、4020/5193、4030/5203）。失败排查：分支已存在同名 worktree、端口被占用（命令会自动杀掉）、缺少 bun 依赖、git worktree 报错（先处理未提交改动）。
这个 Skill 与同类方案有什么区别？
同仓库的 Claude Code Hooks Mastery 项目（README 中链接）覆盖 hook 系统本身；相比之下本技能聚焦 worktree 编排，属于同作者的 Claude Code 工作流生态。除此之外源材料未提供其他可比对象。