SuperAPI AI 工具集

worktree

编程与开发

查看项目

更新于 11-05 16:17

技能介绍

用途

worktree 是一个隔离会话与分支的引擎,用于在专用 Git worktree 中隔离并行的智能体会话,防止工作区冲突。其核心思路是把所有分支编辑、shell 命令和测试执行严格限制在 .agents/worktree/<branch> 路径下,禁止工作树会话修改根仓库文件。

主要能力

  • 路径隔离:所有操作限定在 .agents/worktree/<branch> 内。
  • 脏树保护:删除工作树前通过 git status --porcelain 检查,存在未提交修改时禁止删除。
  • 变更前授权门:创建或删除工作树需以 Canonical Changeset 格式暂存计划,并暂停等待人工确认后才在磁盘执行。
  • 分支命名规范:分支须为 <type>/<slug> 格式,类型包括 feat/、fix/、refactor/、chore/、test/。
  • 隐私锚点:根 .gitignore 必须包含 .agents/worktree/。
  • 支持创建、删除、列出、清理(通过 scripts/prune-squashed.sh 安全清理已压缩合并的分支)四类操作。

使用方式

技能按三阶段协议执行。第一阶段预检与冲突审计:创建前检查 git worktree list 确认无分支或目录冲突;删除前检查目标路径内 git status --porcelain,若有未提交文件则立即停止并报告;列出时运行 git worktree list 并暂停。第二阶段以 Canonical Changeset 格式暂存计划变更,展示摘要并暂停等待人工授权。第三阶段批准后原子执行:创建用 git worktree add <path> -b <branch> <base_ref>;删除用 git worktree remove <path> && git worktree prune;清理用 bash scripts/prune-squashed.sh <target_branch>,完成后报告绝对工作区路径供 IDE 导航。

适用场景

适合多智能体并行开发、需要为不同任务建立独立分支工作区的场景,以及要求人工确认后才改动磁盘的受控开发流程。

限制

目前资料未提供安装方式、收费、平台支持等具体信息;实际使用需依赖 Git worktree 与相应脚本环境。