Agent Skills
返回列表
💻

Git Worktree 隔离工作区

开发编程 更新于 2026.08.30

将以下提示词粘贴到你的 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 的全栈开发者