用途:当已验证的工作需要集成或清理任务创建的分支/工作树,或用户明确要求合并、PR、分支生命周期处理时使用。核心原则是:新证据→授权集成→归属感知清理→Git/路径回读。
主要能力:检测环境与归属(读取 TaskStartSnapshot、HEAD、分支/分离状态、上游分叉、活动 Git 操作、暂存/未暂存/未跟踪路径、git worktree list --porcelain、创建者与基础分支);执行最小当前权威测试集验证;提供四种授权结果:本地合并到记录的基础分支、推送并创建/更新 PR、保留分支、丢弃任务自有分支/工作树。
使用方式:开始时说明关闭哪个分支/工作树生命周期。遇到冲突、分离状态、验证失败、清理目标脏/未跟踪、归属未知时停止。不得从 main/master 名称推断基础分支。禁止自动 stash、reset、clean、pull、rebase、amend、force-push 或绕过钩子。推送、PR、远程删除、发布、强制操作需用户明确授权;丢弃需精确输入确认,命名分支、工作树路径和将丢失的提交/增量。
清理顺序:先移到其他安全检出,用 git worktree remove <exact-path> 移除/注销工作树,回读 git worktree list --porcelain,确认路径不存在,再删除已集成或精确确认的分支,回读分支引用、HEAD 和仓库状态。不得常规使用 --force、全局 prune、通配符删除或清理归属记录外的资源。Windows 上目录可能被锁定,需重新检查注册与解析路径,仅移除已证明的任务自有干净残留,否则保留并报告。
集成证明:合并/快进需证明任务尖端是记录基础分支的祖先;squash/rebase 需用 PR 合并元数据加策略匹配的补丁等价性(git cherry、稳定 patch-id 或有界路径/树比较),不能仅用祖先测试;未合并/开放 PR 保留分支,除非精确确认丢弃。不得仅因打开 PR 或存在同名提交就删除分支。
最终回执:报告当前分支与提交 SHA/消息或不存在提交的原因;Task clean 与 Repository clean 独立报告;分支/工作树创建、移除或保留及证据/原因;集成证据与剩余用户操作。该回执是本地 Git 回执,不构成超出回读证据的权威完成或合并事实。与 using-git-worktrees 和 verification-before-completion 配合使用。