用途:编排 git worktree 从创建到清理的完整生命周期,是开发工作流的前半段,负责把会话带入 worktree 并保持其健康;/pull-request 负责后半段(准备、创建 PR、监控、合并)。worktree 是并行代码修改的隔离机制,可让多个 Claude Code 会话在不同任务上互不干扰。
主要能力:动作由 $ARGUMENTS 首词选择。空参数为智能默认,检测当前状态并建议动作;create [name] 校验名称、说明设置并调用 EnterWorktree;status 列出所有 worktree 及其 PR 状态与陈旧度;cleanup [--dry-run] 清理孤立元数据、已合并 PR 分支与陈旧 worktree;audit 运行 status 并检查配置健康。
使用方式:先收集仓库上下文,每条命令单独调用,如 git branch --show-current、git worktree list | head -30、git rev-parse --git-dir、git rev-parse --git-common-dir。创建须通过共享 helper 而非 EnterWorktree(name:),将 worktree_root 写入临时文件并用 --root-file 传入;helper 非零退出时停止,不得回退到 EnterWorktree(name:)。最后以 EnterWorktree(path: "<printed-path>") 进入,之后不得再执行任何操作。
限制:不推送、创建、合并或关闭 PR;不提交或暂存代码;不运行 CI、构建、测试或 lint;不管理远程分支;不强制分支命名。gh 不可用时跳过 PR 交叉引用。非 git 仓库时所有动作立即退出。worktree_stale_days 无效时回退 14 天默认值。worktree 位于外部 worktree_root,不得嵌套在仓库内。