SuperAPI AI 工具集

git-worktree-agent-workflow

办公与效率

查看项目

更新于 10-15 23:49

技能介绍

用途:为每个实现任务(单个 issue、功能或修复)创建独立 worktree,使主工作目录始终停留在 main 且保持干净,实现隔离、聚焦的开发,并支持多 issue 并行处理与子代理委派。

主要能力:默认隔离,每个任务一个目录、一个分支、一个 PR;worktree 共享 .git 数据库,无需克隆;可同时激活多个 worktree;提供编排者与子代理的角色分工,编排者负责创建 worktree、派发子代理、验证结果、顺序推送并创建 PR、清理,子代理只在指定 worktree 内实现、测试并提交单一聚焦 commit。

使用方式:先确保 main 干净,执行 git fetch origin --prune 与 git status --porcelain;创建 worktree,如 git worktree add ./worktrees/issue-47 -b wt/issue-47 origin/main;在 worktree 内实现并运行测试,如 cd ./worktrees/issue-47 && npm test;验证用 git -C ./worktrees/issue-47 log --oneline origin/main..HEAD 与 git -C ./worktrees/issue-47 diff --stat origin/main;推送并创建 PR,如 git -C ./worktrees/issue-47 push -u origin wt/issue-47 与 gh pr create --head wt/issue-47 --base main;完成后用 git worktree remove ./worktrees/issue-47、git worktree prune 清理。命名约定:issue 用 ./worktrees/issue-{N} 与 wt/issue-{N},功能用 feat-{name},修复用 fix-{name}。

适用场景:开始任何实现任务、处理功能或修复、并行处理多个 issue、向子代理委派工作。

限制:阅读代码或调研、快速单行编辑、交互式调试、已在 worktree 内时建议使用标准工作流;每个 worktree 是独立目录树,若项目使用 node_modules 等需在 worktree 内重新安装依赖;PR 建议顺序处理以保持历史干净。