用途:从上游仓库池(source-pool)中操作隔离的、面向任务的 worktree,让每个工作项拥有独立目录,避免污染上游仓库。
核心不变量:source-pool 是干净、只读的上游仓库池,跟踪主干分支,不得在此做脏编辑、运行构建或放置临时产物;workspace 是任务目录根,每个工作项对应 <workspace>/<task-name>/,worktree 在此检出;single-owner 指一个任务目录属于一个活跃工作流,多仓库依赖共置于同一任务目录下。
主要能力与用法: start-task:创建 <workspace>/<task-name>/,对 source pool 中每个所需仓库添加 worktree: git -C <source>/<repo> worktree add <workspace>/<task-name>/<repo> -b <branch> [start-point] 起点可为默认主干、较旧提交或已有分支。 multi-repo:任务跨多个仓库时,将所有受影响仓库的 worktree 直接检出到 <workspace>/<task-name>/。 add-repo:任务中途需要未克隆依赖时,先克隆到 source pool,再向当前任务目录添加 worktree。 tear-down:代码合并或放弃后,删除任务目录(rm -rf <workspace>/<task-name>)并清理 worktree 引用: git -C <source>/<repo> worktree prune source pool 保持原状。
设置与迁移:初始化新的 source/workspace 布局、生成本地 AGENTS.md 规则或迁移现有仓库,需阅读 references/setup.md。
限制:资料未提供具体平台、收费、价格或效果信息;使用需自行准备上游仓库池与工作区目录结构。