using-git-worktrees

核心用法

该 Skill 提供了一套标准化的 Git Worktree 创建流程，旨在为功能开发提供完全隔离的工作空间。其核心流程遵循"目录优先级选择 → 安全验证 → 自动配置 → 基线测试"的四步方法论。首先，系统会按优先级检查 .worktrees 或 worktrees 目录是否存在，或查询 CLAUDE.md 中的配置偏好，必要时询问用户。其次，进行关键的安全验证：对于项目本地目录，必须确认其已被 .gitignore 忽略，否则会自动修复并提交忽略规则，防止工作区内容意外进入版本控制。随后，根据检测到的项目类型（Node.js、Rust、Python、Go 等）自动执行依赖安装，最后运行测试套件验证环境基线是否干净。

显著优点

最大的优势在于开发隔离性。通过 Git Worktree，开发者可以在完全不切换分支的情况下，在多个功能分支上并行工作，避免了传统分支切换带来的上下文中断和潜在冲突。其次，流程标准化确保了团队成员遵循统一规范，特别是强制性的 gitignore 验证机制，从源头上杜绝了将工作区文件误提交的风险。第三，自动化环境搭建智能识别项目技术栈并执行相应的构建命令，显著降低了新工作区的准备时间。此外，该 Skill 与 brainstorming、subagent-driven-development 等技能深度集成，成为 Claude Code 开发工作流的基础设施组件。

潜在缺点与局限性

尽管功能完善，仍存在若干局限。首先是磁盘空间开销，每个 Worktree 都会占用独立的文件系统空间，对于大型项目或存储受限的环境可能不适合频繁创建。其次，来源可信度为 T3 级（个人开发者账号），虽然内容透明可审计，但长期维护稳定性和企业级支持保障相对较弱。第三，技术栈覆盖有限，目前仅内置了 Node.js、Rust、Python、Go 等主流语言的自动检测，对于其他语言或特殊构建系统的项目，依赖安装步骤可能需要手动调整。此外，基线测试阻塞机制虽然安全，但在遗留项目测试本就失败的场景下，可能增加额外的沟通成本。

适合的目标群体

该 Skill 特别适合需要频繁在多个功能间切换的开发者，如全栈工程师、技术负责人或开源贡献者。对于遵循 Claude Code 标准化开发流程的团队，这是强制执行隔离开发策略的必备工具。此外，微服务架构维护者可利用其为不同服务创建独立工作区，Code Reviewer 可借助 Worktree 快速切换至待审查分支而不影响当前开发进度。任何希望避免"stash/pop"循环、追求零干扰并行开发的 Git 重度用户都将从中受益。

使用风险与注意事项

主要风险集中在配置误用方面。若忽略 gitignore 验证步骤，可能导致整个 Worktree 目录被意外提交至仓库，造成仓库污染。用户需确保对 ~/.config/superpowers/worktrees 全局目录有适当权限，否则可能遇到创建失败。在执行风险上，虽然 Skill 本身为纯文档，但其中的 bash 示例命令（如 npm install）在实际执行时需注意网络环境和依赖源的安全性。此外，测试基线失败时的处理需要人工判断，若强行在已有失败测试的基础上开发，可能导致问题归因困难。建议在使用前确保主分支的测试处于通过状态。