技能 using-git-worktrees
📦

using-git-worktrees

安全 ⚙️ 外部命令📁 文件系统访问

为功能开发创建隔离的 git 工作区

也可从以下获取: obra,Cycleaddict,davila7,Cygnusfear,Doyajin174,DYAI2025,ZhanlinCui,CodingCossack

开发者在多个分支之间切换时常常面临上下文切换的困扰。此技能创建隔离的 git worktree,让您可以并行开发多个功能而不会丢失当前工作区状态。

支持: Claude Codex Code(CC)
🥉 74 青铜
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“using-git-worktrees”。 为新支付功能创建 worktree

预期结果:

我正在使用 using-git-worktrees 技能设置隔离的工作区。

Worktree 已就绪,位于 /projects/myapp/.worktrees/feature/payments
测试通过(47 个测试,0 个失败)
已准备好实现支付功能

正在使用“using-git-worktrees”。 设置工作区来审查 api-v2 分支

预期结果:

我正在使用 using-git-worktrees 技能设置隔离的工作区。

检测到现有的 .worktrees 目录
已验证目录已添加到 git 忽略列表
已创建 worktree:git worktree add .worktrees/api-v2 -b api-v2
已安装依赖:npm install
基准测试:23 个通过

Worktree 已就绪,位于 /projects/myapp/.worktrees/api-v2

安全审计

安全
v1 • 2/25/2026

All 43 static findings evaluated as false positives. External commands are standard git and build tools with hardcoded or trusted arguments. Filesystem operations are legitimate directory checks. No command injection vectors, credential exposure, or malicious patterns detected.

1
已扫描文件
223
分析行数
2
发现项
1
审计总数
审计者: claude

质量评分

38
架构
100
可维护性
87
内容
50
社区
100
安全
91
规范符合性

你能构建什么

功能开发隔离

在开始新功能分支的工作时不会丢失未提交的更改或破坏当前工作区状态

代码审查准备

创建干净的隔离工作区来审查和测试拉取请求的更改,不影响本地开发

Bug 修复重现

在独立的工作区中隔离 bug 调查工作,同时保持稳定的开发环境

试试这些提示

基础 Worktree 设置
使用 git worktrees 为 feature/auth-improvements 分支设置隔离工作区
自定义目录 Worktree
在 .worktrees 目录中为 bugfix/memory-leak 创建 worktree 并运行项目安装
PR 审查工作区
从 pull-request-123 分支创建一个隔离的 worktree,这样我可以审查更改而不影响当前工作
多分支开发
我需要在 experimental/caching 分支上工作,同时保持当前更改完整。设置 worktree 并验证测试通过

最佳实践

  • 在创建前始终验证 worktree 目录已添加到 git 忽略列表,防止意外提交
  • 在 worktree 创建后立即运行基准测试,建立干净的起点
  • 遵循目录优先级顺序:现有目录 > CLAUDE.md 偏好 > 询问用户

避免

  • 创建 worktree 时未验证 git 忽略状态,导致版本控制中出现工作区污染
  • 跳过基准测试验证,无法区分新 bug 和预先存在的问题
  • 硬编码目录位置,而不是先检查现有目录和用户偏好

常见问题

什么是 git worktree,为什么要使用它?
git worktree 是一个链接的工作目录,共享同一个仓库。它允许您同时在多个分支上工作而无需切换,保持每个工作区隔离并保留未提交的更改。
Worktree 在哪里创建?
Worktree 创建在 .worktrees/(项目本地)、worktrees/(替代项目本地)或 ~/.config/superpowers/worktrees/<project>/(全局位置)。此技能遵循优先级顺序,如果没有偏好则会询问用户。
我需要在每个 worktree 中安装依赖吗?
是的,每个 worktree 都有自己的工作目录。此技能会自动检测您的项目类型(npm、cargo、pip、poetry、go)并运行相应的安装命令。
如果基准测试失败会发生什么?
技能会报告测试失败情况,并询问您是希望进行调查还是继续操作。这确保您在做出新更改之前了解起始状态。
我可以同时拥有多个 worktree 吗?
是的,git 支持多个 worktree。每个 worktree 独立运行,允许您在单独的终端会话中并行开发不同的分支。
完成后如何清理 worktree?
使用 finishing-a-development-branch 技能或运行 'git worktree remove <path>' 来删除 worktree。主仓库和其他 worktree 不受影响。

开发者详情

文件结构

📄 SKILL.md