Git Worktree 隔离工作区
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-02qudk26/using-git-worktrees-zh。
技能介绍
要解决什么问题
在同一仓库里并行处理多个分支时,频繁 git checkout 会打断上下文,也容易把未提交的改动和分支切换搅在一起。Git worktree 可以在共享同一 .git 的前提下开出隔离工作目录,但目录放哪、会不会被误提交、新目录是否从「干净基线」起步,都需要一套固定流程,而不是凭感觉执行 git worktree add。
技能如何工作
本技能以 目录选择 → 安全验证 → 创建与验收 为主线。
- 目录优先级:若已有
.worktrees/或worktrees/则沿用(两者并存时优先.worktrees/);否则读CLAUDE.md中的偏好;仍无约定则向用户确认。全局目录可使用~/.config/superpowers/worktrees,不占用仓库树。 - 安全验证:项目内 worktree 目录在创建前必须用
git check-ignore确认已被忽略;若未忽略,按「先修再建」写入.gitignore并提交,避免 worktree 内容进入git status。 - 创建后流程:识别项目名、创建 worktree、按
package.json、Cargo.toml等自动推断并执行依赖/环境设置;再跑测试建立清洁基线,失败时报告并询问是否继续。
适用边界与注意点
- 项目本地 worktree 不能跳过忽略校验;不能在基线测试失败时默许继续;不能在位置不明时硬编码目录或安装命令。
- 常与 finishing-a-development-branch(收尾清理)、executing-plans / subagent-driven-development(在隔离区实施)及 brainstorming 阶段 4 等流程配合使用。
使用场景
- 主工作区还留着未提交改动,却要在新分支上按已批准方案改代码,需要另开目录而不切换当前 checkout
- brainstorming 进入阶段 4、设计已批准要落地实现时,需要为实施单独建隔离 worktree
- 一边在默认目录处理 hotfix,一边在 worktree 里长跑 feature 分支的构建与测试
- 执行 executing-plans 或 subagent-driven-development 前,要为子任务准备独立目录并先跑通基线测试
适合人员
- 同一仓库要同时维护主线与功能分支、又不想频繁 checkout 的后端工程师
- 用 Agent 做方案到落地全流程、需要在批准后立即开隔离区写代码的技术负责人
- 曾在项目内 worktree 目录未进 .gitignore 导致 `git status` 被污染、希望流程强制校验的维护者
- 功能分支开发结束后要按 finishing-a-development-branch 清理 worktree 的全栈开发者