用途:该技能面向使用 Git worktree 的并行开发工作流。每个 worktree 或智能体拥有独立的分支、端口、环境文件与运行服务,避免共享状态与冲突,便于同时处理功能开发、热修复和 PR 审查。
主要能力 worktree 生命周期管理:从新分支或已有分支创建 worktree,采用确定性命名,复制 .env 文件,依据 lockfile 检测并安装依赖,列出 clean/dirty 及 ahead/behind 状态,并在检测到未提交改动时安全移除。 端口分配:按“base + index * stride”进行确定性分配,检测与运行进程的端口冲突,将映射持久化到 .worktree-ports.json,并生成 Docker Compose 覆盖文件。 多智能体隔离:一个 worktree 对应一个分支和一个智能体,无共享状态,支持任务 ID 映射以便追踪。 清理自动化:按存在时长识别过期 worktree,检测已合并分支以安全移除,提示 dirty 状态,并在安全确认下批量清理。
使用方式:通过三个脚本调用。列出及增删清理使用 python scripts/worktree_manager.py list;查看或分配端口使用 python scripts/port_allocator.py status;健康检查使用 python scripts/worktree_validator.py --stale-days 14。执行前需确认操作类型、分支与基线、端口或服务需求;若信息不明确应询问,用户表示直接起草时可先行并列出假设。相关细节见 references 下的 setup-and-ports.md、cleanup-and-workflows.md、operations-playbook.md。
适用场景:需要同时打开两个以上分支并运行开发服务器;为功能、热修复和 PR 审查提供隔离环境;多个 AI 智能体需要互不干扰的工作区;当前分支被阻塞但有紧急热修复;希望以自动清理替代手动删除。
限制:不涉及 Git 分支策略或合并冲突解决,不负责密钥轮换、凭据管理,不涵盖 CI/CD 配置或测试编排,也不处理 monorepo 包管理与跨包依赖解析。这些由其他技能承担。具体价格与平台支持情况暂未提供。