SuperAPI AI 工具集

agent-worktrees

智能体与模型

查看项目

更新于 10-16 07:15

技能介绍

用途:当同一 git 仓库上有两个或更多 AI 代理并行工作时,用分支加 worktree 的方式隔离各自的工作区,避免互相干扰;若用户或产品明确要求共享,则按要求执行。方法细节见 METHODOLOGY.md,对话流程说明见 RESPONSE.md。

主要能力与流程:先判断是否需要隔离(同仓库至少 2 个代理则应隔离;结构性文件重叠的改动仍应串行)。若当前已处于 worktree 且任务分支已存在,则跳过创建,只在缺少共享链接时执行设置。否则从 main 创建分支与 worktree,分支名优先沿用已跟踪的 Linear 名称,不重复创建 Claude Code 的 claude/<name> 目录树。环境共享使用符号链接而非复制,命令为 bash scripts/worktree.sh setup。随后占用自动分配端口的预览服务,声明分支与任务,并在每条消息末尾输出状态行:🔌 <branch> · <one-line task> · <preview URL>。

收尾步骤:先停掉预览、清理认领标记,再依次执行 bash scripts/worktree.sh land <branch>、git push origin main、bash scripts/worktree.sh teardown ../<repo>-<slug> <branch>。完成检查依据评分标准,需达到 12 项中至少 10 项且无零分。

安装与使用:在仓库中安装参见 METHODOLOGY 第 4 节;优先使用仓库已有的 scripts/worktree.sh,否则从此包复制,可选 worktree.share 配置,并把六步协议写入代理指令,做一次冒烟测试。

限制:不适用于单代理在主目录工作的情况;共享数据库上的模式迁移策略仅要求串行,未提供更多方案;空闲时自动拉取属于相邻问题,不在范围内。其余细节资料暂未提供。