SuperAPI AI 工具集

worktree

通用与其它

查看项目

更新于 10-15 20:33

技能介绍

用途:为需要与当前工作区隔离的任务提供受控的 git worktree 生命周期管理。它是子技能,由 /execute(mode=solo)或 dispatch 漏斗调用,不是 /route 目的地。

主要能力:检测当前目录是否已在链接的 worktree 中并适配而非重建;区分 submodule;通过 doctrine worktree fork --base <B> --branch <name> --dir <path> [--worker] 创建并配置 fork,失败时补偿回滚;提供 doctrine worktree coordinate --slice <N> --dir <path> 用于每次运行的协调树;提供 doctrine worktree provision <fork> 作为独立复制器;提供 doctrine worktree check-allowlist 静态检查;提供 doctrine worktree branch-point-check --base <B> 批次提交边界守卫。

使用方式:先检测隔离,选择目录(.worktrees 优先,检查 CLAUDE.md 偏好,否则询问用户),确保目录被 gitignore,运行 commit-before-spawn 守卫,再调用 fork。fork 自动配置,不要运行第二个复制器。创建后在 fork 内运行项目提供的 regenerate-and-verify 命令,绿色基线才可交接。worker 模式必须显式指定 --base <B>,不得降级为就地工作。

适用场景:solo 模式可选隔离;dispatch 每个 worker 必须隔离;协调树每次运行创建或恢复。

限制:worker 模式无真实 fork 即硬失败;不得从脏树 fork 或交接红色基线;check-allowlist 只是静态嗅探,不保证完整性;harness 原生创建仅机会性使用,不可依赖;持久记忆应记录在 trunk 而非 fork 分支内。具体项目命令与配置由项目提供,资料未给出通用默认值。