用途：在多分支并行开发时，用 Git worktree 隔离各分支的开发环境，避免分支间互相干扰。特别适合多智能体或多终端会话中，每个智能体独占一个工作树的场景。
主要能力：从新建或已有分支创建工作树并采用确定性命名；为每个工作树自动分配不冲突端口并持久化记录；从主仓库复制 .env* 本地环境文件；根据锁文件检测结果可选安装依赖；清理前检测陈旧工作树与未提交改动；识别已合并分支并安全移除过期工作树。
使用方式：通过脚本操作。创建时可运行 python scripts/worktree_manager.py --repo . --branch feature/new-auth --name wt-auth --base-branch main --install-deps --format text；也支持从标准输入或 --input file 读取 JSON 配置，并用 --format json 输出。清理时运行 python scripts/worktree_cleanup.py --repo . --stale-days 14 --format text 或加 --remove-merged。脚本支持 --help 查看接口。端口策略默认按 base + index * stride 并做冲突检查，示例基值：App 3000、Postgres 5432、Redis 6379，stride 10。
适用场景：需要本地同时打开 2 个以上分支；需要为功能、热修和 PR 验证提供隔离开发服务器；多个智能体不能共享同一分支；当前分支受阻但需快速修复；希望用可重复清理替代临时删除操作。
限制与注意事项：不要在主仓库目录内创建工作树；避免所有分支共用 localhost:3000 或同一数据库 URL；不要移除有未提交改动的工作树；删除分支后需修剪旧元数据；判断已合并状态需对照目标分支。工作树应短命，合并后移除；端口映射需落盘保存；除非确认丢弃改动，否则不要强制移除脏工作树。安装与更多模板细节见 README.md、port-allocation-strategy.md 和 docker-compose-patterns.md。