mcpField
W
worktree-create

worktree-create

github.com/coleam00开发722209 次安装3 周前更新
代码仓库

关于 worktree-create

worktree-create 是用于创建并准备隔离 Git 工作树的技能，适合需要并行处理分支的开发者。它会从仓库检测项目配置，并为多个工作树并行分配设置子 Agent。

主要功能

  1. 01按分支创建 Git 工作树
  2. 02检测安装与健康检查命令
  3. 03复制所需的忽略配置
  4. 04安装依赖并运行构建步骤
  5. 05为服务分配不同端口
  6. 06汇总就绪状态与清理步骤

适用场景

  1. 01并行处理多个分支
  2. 02为开发准备隔离分支环境
  3. 03开始工作前检查工作树状态

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/coleam00/skills --skill worktree-create

安装后在 Claude Code 中输入/worktree-create确认已加载。

附带文件references/worktree-setup.md

详细介绍

Worktree 创建

从分支列表中创建任意数量相互隔离的 git worktree——每个 worktree 都基于正确的基础分支创建，配有其 git 忽略的配置和依赖，并通过健康检查；为每个 worktree 分配一个设置子 Agent，让它们并行运行。每个 worktree 的操作都与应用无关，并且根据仓库检测，绝不硬编码。

输入

$ARGUMENTS 是要创建的分支列表。

  • 未提供分支 → 询问要创建哪些分支（或提出根据正在处理的工单推导分支）。不要猜测。
  • 一个分支 → 直接设置单个 worktree（只有一个就不必分派）。
  • 两个或更多分支 → 为每个分支分派一个子 Agent，并行运行。

分派前检测一次项目设置

阅读 references/worktree-setup.md——其中列出了全新 worktree 所需的一般检查清单，以及检测每项内容的方法。根据当前仓库（而非假设）一次性确定：

  • 安装命令（monorepo → 每个包各一个），
  • 要复制的 git 忽略的环境/配置文件（或仓库的 .worktreeinclude），
  • 验证/健康检查命令（如果应用提供健康端点，则使用该端点；否则执行构建/测试冒烟检查——优先使用 CI 执行的内容），
  • 基础端口，仅当健康检查会启动服务时才需要。

选择 worktree 根目录（worktrees/<branch>，需 git 忽略）；如果要启动服务，为每个 worktree 分配不同端口，即 base + index，以避免并行服务发生冲突。

为每个分支并行分派一个设置子 Agent

使用 Task 工具一次性启动所有子 Agent。给每个子 Agent 相同的提示词，只替换 BRANCH 和 PORT：

Set up a git worktree for branch: BRANCH   (assigned port: PORT, only relevant if you start a service)

Follow the checklist in .claude/skills/worktree-create/references/worktree-setup.md. Concretely:
1. Create the worktree off the base branch:  git worktree add worktrees/BRANCH -b BRANCH
2. Copy the gitignored config/secrets the project needs into worktrees/BRANCH
   (the env/config files detected for this repo; verify each with `git check-ignore` before copying).
3. Install dependencies with the project's detected package manager (every package, for a monorepo).
4. Run any generate/build step the app needs to boot (skip if none).
5. Verify: run the detected health check (start + hit the health endpoint on PORT if there is one,
   else a build/typecheck/test smoke). Then stop any server you started.

Report exactly: worktree path · branch · deps installed (yes/no) · health check (PASS/FAIL) · any errors.

将检测到的命令（安装、环境文件列表、健康检查）填入模板。只有一个分支时，直接执行这些步骤，不要启动子 Agent。

汇总并报告

收集报告并输出每个 worktree 的摘要（路径 · 分支 · 依赖 · 健康状态 · 端口）、一行合计的 N worktree(s) ready、下一步操作（打开每个 worktree／在其中启动 PIV 循环），以及清理提醒：分支合并后执行 git worktree remove worktrees/<branch>。

如果任何 worktree 未通过健康检查，请明确指出，不要将其报告为已就绪。

资源

  • references/worktree-setup.md——全新 worktree 所需内容的一般性、与应用无关的检查清单，以及针对不同项目检测各项内容的方法。检测设置前请先阅读。

评论

支持 Markdown