SuperAPI AI 工具集

git-worktrees

编程与开发

查看项目

更新于 10-15 17:34

技能介绍

用途:为新的开发工作或指定的分支、PR、标签、提交建立或复用隔离的 Git worktree,避免影响用户的主检出。资料强调隔离往往已由编码工具在会话开始前创建,因此应先检测再创建。

主要能力:区分“新工作”(默认,未指定 ref,从请求的基线或环境默认基线新建分支)与“现有 ref”(隔离指定分支、PR、标签或提交,可附着本地分支或在必要时使用 detached 模式)。检测当前检出是否为普通检出、链接 worktree 或子模块,并复用已有隔离。

使用方式:先选择模式,再检测现有隔离。用 git rev-parse --absolute-git-dir 与 (cd "$(git rev-parse --git-common-dir)" && pwd -P) 比较路径;路径不同时用 git rev-parse --show-superproject-working-tree 区分子模块与链接 worktree。复用隔离时用 git rev-parse --show-toplevel、git branch --show-current、git rev-parse HEAD 验证。仅在普通检出时按环境路由到 claude-code.md、harness-native.md 或 git-only.md 之一,并只读一个文档。

结果契约:每条终止路径报告 Workspace、Mode、State、Source、Status;被阻塞时引用最短决定性错误并说明所需用户决定。

限制:不得嵌套 worktree,不得在两个 worktree 中检出同一分支;隔离失败后未经用户明确批准不得回退到当前检出;不得自动切换机制或返回本文件。