不再来回切换分支:用 Claude Code 技能做 Git 工作树,3 步搞定多分支并行开发
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
Superpowers 是一个 Claude Code 技能框架,它的 Git 工作树能力就是冲着这类场景来的:你在 feature/auth 上写了一半功能,突然要回 main 修个紧急 bug——git stash、checkout、修完再切回来、stash pop,一来一回折腾二十分钟,每换一次上下文都得重演一遍。而工作树(worktree)是同一仓库的独立检出目录:每个分支住进自己的目录,互不踩踏。
它到底帮你省了什么
算笔具体的账:不再手动 clone(一个工作树共享仓库的 .git);不再反复 stash/checkout(一个开发周期省掉至少 3 次分支切换);不再手动装依赖(环境配置自动化);完工后不用记得删目录(自动化分支清理)。你要做的事只剩一句:告诉它你要做什么。
3 步建好隔离工作区
第一步:确定放在哪。对 Claude 说"我要开始做 auth 功能",它会声明使用 using-git-worktrees 技能,先检查你是否已在某个隔离环境里(避免嵌套重复建),再看目录归属:项目里已有.worktrees或worktrees就用它,都没有就默认项目根目录下的.worktrees/。
第二步:一条命令创建工作树。位置确定后,核心就是一条 git 命令:
git worktree add .worktrees/auth -b feature/auth第三步:环境交给它,你只管开发。创建后它自动识别项目类型、装依赖、跑一遍基线测试,然后报"Worktree ready at ...,tests passing"。之后你在新目录里写代码;完工时由 finishing-a-development-branch 技能接手:先跑全量测试,再给你三个选项——本地合并、推送建 PR、原样保留。选本地合并时,合并验证通过后自动清理:
git worktree remove .worktrees/auth git worktree prune选 PR 路径时它反而会保留工作树——PR 的反馈还得在那儿修。
AI 在背后做的"隐形工作"
你只说了句"要做 auth",但它其实过了一遍三道关:
- 安全校验:在项目内建工作树前,必查
.worktrees是否真的被 .gitignore 忽略;没忽略就补上并提交——否则下次git add .会把整个工作树目录提交进仓库; - 环境识别:看到
package.json跑npm install,看到Cargo.toml跑cargo build,requirements.txt/pyproject.toml走 pip 或 poetry,go.mod走go mod download,哪种命中装哪种; - 基线测试:交付前跑一遍
npm test/pytest,红了就停下来问你继不继续——脏基线不会悄悄混进新开发。
团队协作为什么更顺
- 并行:多人多工作树,同一仓库改不同分支互不干扰;
- 一致性:每个工作树依赖都是自动装的,不会出现"我这儿能跑你那儿不行";
- 切换成本:不用重新 clone,不用切分支。
一个典型 sprint:A 在.worktrees/payment改支付模块,B 在.worktrees/login-fix修登录 bug,两人各跑各的测试,完工各提各的 PR——谁也没替谁checkout过一次。
三个常见坑,各附处理办法
- 现象:
git status里整个.worktrees目录是 untracked,一个git add .就把工作树内容全提交了。原因:目录不在 .gitignore 里。处理:技能创建前会自动补;手动建的话先git check-ignore -q .worktrees验证,再补进 .gitignore 并提交。 - 现象:工作树刚建好,基线测试就红。原因:不一定是环境问题,可能是 main 分支本身就有坏用例。处理:别带着红继续开发,先确认是不是主分支存量问题,是就修完再开工。
- 现象:
git worktree remove报错删不掉。原因:人还站在这个工作树里面。处理:先cd回主仓库目录再删,顺手跑git worktree prune清掉残留注册。
从一条 clone 开始
Superpowers 把"多分支并行开发"从一串手动仪式变成一句对话。把仓库拉下来装上就能试:git clone https://gitcode.com/GitHub_Trending/su/superpowers。两个技能的完整规则写在 using-git-worktrees 和 finishing-a-development-branch,值得各看一遍。
【免费下载链接】superpowersAn agentic skills framework & software development methodology that works.项目地址: https://gitcode.com/GitHub_Trending/su/superpowers
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考