SuperAPI AI 工具集

git-worktree-workflow

办公与效率

查看项目

更新于 10-16 09:28

技能介绍

用途:该技能用于用 git worktree 管理多个功能分支,让每个分支在独立文件夹中同时检出,避免在同一目录反复切换分支,并为每个功能保留独立的 Cursor/IDE 会话历史。

主要能力:支持新建分支或基于已有分支创建 worktree;按配置复制 .cursor/rules、.cursor/skills 等目录;列出、移除和清理 worktree;按 <TICKET>-<Suffix> 命名文件夹、按 <username>/<TICKET> 命名分支;worktree 与主仓库共享 .git 对象,占用较轻量。

使用方式:配置 config.json,包含 repos(main、suffix、copy_dirs)、worktrees_base、username、default_branch。新建分支示例:git fetch origin 后执行 git worktree add <worktrees_base>/<TICKET>-<Suffix> -b <username>/<TICKET> origin/<default_branch>;已有分支则用 git worktree add <path> <existing-branch>。复制配置后可用 cursor <path> 打开。管理命令包括 git worktree list、git worktree remove <path>、git worktree prune。若 config.json 缺失,可先检测仓库名、工作区路径、git 用户名和默认分支,再生成配置。

适用场景:需要同时处理多个功能分支、希望每个功能有独立 IDE 窗口和会话历史、或需要按工单隔离开发环境的场景。

限制:所有 git 与复制命令需 required_permissions: ["all"],因为 worktree 创建在工作区之外且需修改 git 配置,否则会被沙箱阻止;分支已存在或已在别处检出时需改用已有分支或先移除原 worktree;清理构建产物可删除 node_modules、bin、obj 等目录。