worktrees-and-dev-servers

用途

该技能适用于在 Pierre 仓库内进行本地或手动并行开发的场景，特别是当你启动仓库的开发服务器、E2E 测试夹具或 Chrome 远程调试实例时。它提供了一套围绕 Pierre 受管 git worktree 的操作约定，用于避免端口冲突并清理残留进程。

主要能力

受管 worktree 位于 ~/pierre/pierre-worktrees/<slug>/。每个受管 worktree 拥有独立的端口偏移，因此开发服务器、E2E 夹具和 Chrome 远程调试实例不会相互冲突。主克隆保留历史默认端口，链接的 Pierre worktree 则整体偏移端口。

wt 命令套件定义在 scripts/wt.ts，通过 root:wt moon 任务暴露，仅管理 Pierre 受管 worktree。可用命令包括：

• moonx root:wt -- new <slug>：创建 worktree、分配端口偏移并执行 pnpm install
• moonx root:wt -- rm <slug>：终止其进程并移除 worktree
• moonx root:wt -- clean：清理所有受管 worktree 端口上的僵尸服务器
• moonx root:wt -- clean <slug>：清理单个受管 worktree
• moonx root:wt -- ps：显示每个 worktree 的端口状态（LISTEN / -）
• moonx root:wt -- list：列出受管与外部 worktree 的摘要

绑定端口的 moon 任务通过 envFile 选项从 <worktree>/.env.worktree 读取偏移量。启动前，开发任务会运行 scripts/run-dev.sh，终止绑定到目标端口的陈旧进程。

使用方式

如果你已身处 Conductor、Codex、Claude 或其他宿主提供的工作区中，除非用户明确要求 Pierre 受管 worktree，否则不要额外创建 worktree。但当你启动仓库开发服务器或 E2E 夹具时，仍需遵循本技能的清理和端口偏移规则。

清理约定：如果在某个 worktree 内启动了开发服务器、Playwright 夹具或 Chrome 调试实例，请在本轮结束前执行清理：

moonx root:wt -- clean <slug>

当不知道 slug 或需要清理所有受管 worktree 时，使用 moonx root:wt -- clean。仅当确实要拆除 worktree 本身时，才使用 moonx root:wt -- rm <slug>。

适用场景与限制

适用于 Pierre 仓库的本地与手动并行开发，尤其是需要同时运行多个开发服务器、E2E 测试与浏览器调试实例的场合。限制方面：该技能仅管理 Pierre 受管 worktree；在宿主提供的代理工作区中不应重复创建工作树。资料未提供更多关于其他平台、收费或价格的信息。