SuperAPI AI 工具集

worktrees

编程与开发

查看项目

更新于 10-15 21:09

技能介绍

用途:协调多个 Claude 会话在同一代码库上并行开发。Worker 是独立的 Claude 会话而非子代理:Manager 创建 worktree,用户在每个 worktree 中打开新终端运行 claude,各实例独立工作。

核心概念:PLAN.md 记录工作流、文件所有权与决策;STATUS-{name}.md 记录各工作流进度,合并前必须存在;Manager 在主分支规划、创建/合并 worktree 并监控;Worker 在 worktree 中执行、遵守文件所有权并写状态。

角色判断:运行 git branch --show-current,main 或 master 为 Manager,wt/* 分支为对应工作流的 Worker。

Manager 流程:先做预检(基础代码已提交、依赖安装与构建通过、共享文件就绪、工作流间无文件所有权重叠);创建 PLAN.md 并明确文件所有权(如 apps/web/components/layout/* 安全,apps/web/** 过宽易冲突);创建 worktree:git worktree add ../projectname-{name} -b wt/{name},进入后安装依赖;提示用户在各目录运行 claude;定期检查提交、STATUS 文件与未提交改动;仅当 STATUS 显示可合并且构建通过时合并,随后清理 worktree 与分支并更新 PLAN.md。

Worker 流程:阅读 PLAN.md 确认范围与所有权,只修改自己负责的文件,频繁提交,遇到依赖其他工作流的事项记为阻塞,完成前必须写 STATUS-{name}.md 并验证构建。

限制:文件所有权不明确会导致合并冲突;worktree 是同级目录而非子目录;未写 STATUS 视为未完成;合并后构建失败需按依赖顺序合并。资料未提供收费、价格与平台信息。