SuperAPI AI 工具集

git-worktree

编程与开发

查看项目

更新于 10-15 19:56

技能介绍

用途:Git Worktree 技能帮助在同一个仓库中同时处理多个分支,避免频繁切换分支或暂存改动。每个 worktree 拥有独立工作目录和分支,但共享同一 Git 对象数据库。

主要能力:列出、创建、移除、清理和修复 worktree;支持从 HEAD、指定基础分支或远程分支创建;可配合并行 Claude Code 会话、独立进度跟踪和 PR 隔离审查。

使用方式:先运行 git worktree list 查看现有 worktree,再用 git worktree add ../project-feature-name -b feature-name 创建,进入目录后正常安装依赖、运行测试或启动会话。管理命令包括 git worktree remove、git worktree prune、git worktree repair。建议将 worktree 放在仓库目录之外,并可配置 git config worktree.guessRemote true 与 git config worktree.useRelativePaths true(需 Git 2.45+)。

适用场景:多分支并行开发、紧急热修复、隔离审查 PR、跨分支测试而不暂存改动。

限制:同一分支不能同时在多个 worktree 中检出;移除含未提交改动的 worktree 需先提交或暂存,或使用 -f 强制移除;手动删除目录后需用 git worktree prune 清理元数据。快速切换分支或单分支单功能流程不建议使用。