用途:解决并行智能体作业导致 worktree 与分支泛滥的问题,把散乱的分支收敛成规范主线加少量受保护分支,同时保留有价值的工作。
主要能力:提供只读审计脚本 scripts/audit.sh 与引导式整理脚本 scripts/rationalize.sh(支持 --staging 参数指定暂存分支)。工作流分四阶段:清点(只读,列出 worktree 与本地分支并分类)、收割(将保留内容汇聚到暂存分支)、确认包含(证明每个待删分支内容可达)、修剪(最后执行删除)。产出 .agents/worktree-rationalization/report.md 报告,含前后计数、受保护集合、收割提交列表、删除原因与 SHA。
使用方式:先运行 bash {baseDir}/scripts/audit.sh 清点;再运行 bash {baseDir}/scripts/rationalize.sh --staging rationalize/$(date +%Y%m%d) 执行整理,破坏性步骤前会暂停确认。默认用 git branch -d,仅在逐项确认已收割后才用 -D。遇到 git worktree remove 报“contains modified or untracked files”时,先提交到 salvage 分支;git branch -d 报“not fully merged”时回到收割阶段;worktree 路径消失可用 git worktree prune。
适用场景:智能体群作业后的大量孤立 worktree、脏工作树、重复或漂移分支的清理与对账。
限制:绝不动默认分支、发布/维护分支及有开放 PR 的分支;不得在脏工作树上执行强制移除;删除前必须证明内容已被暂存分支包含,或在报告中列为故意放弃。文档未提供安装方式、权限、平台限制与收费信息。