Git worktrees 创建共享同一仓库的隔离工作区，允许在不切换分支的情况下同时在多个分支上工作。

核心原则： 系统化的目录选择 + 安全检查 = 可靠的隔离。

开始时声明： "我将使用 using-git-worktrees 技能来设置一个隔离的工作区。"

# 按优先级顺序检查
ls -d .worktrees 2>/dev/null     # 首选（隐藏）
ls -d worktrees 2>/dev/null      # 备选

如果找到： 使用该目录。如果两者都存在，.worktrees 优先。

grep -i "worktree.*director" CLAUDE.md 2>/dev/null

如果指定了偏好： 直接使用，无需询问。

如果不存在目录也没有 CLAUDE.md 偏好：

未找到工作树目录。我应该在哪里创建工作树？

1. .worktrees/（项目本地，隐藏）
2. ~/.config/superpowers/worktrees/<项目名>/（全局位置）

您更倾向于哪个？

对于项目本地目录（.worktrees 或 worktrees）

在创建工作树之前必须验证目录已被忽略：

# 检查目录是否被忽略（尊重本地、全局和系统 gitignore）
git check-ignore -q .worktrees 2>/dev/null || git check-ignore -q worktrees 2>/dev/null

根据 Jesse 的规则"立即修复损坏的东西"：

为什么关键： 防止意外将工作树内容提交到仓库中。

对于全局目录（~/.config/superpowers/worktrees）

无需 .gitignore 验证——完全位于项目外部。

project=$(basename "$(git rev-parse --show-toplevel)")

# 确定完整路径
case $LOCATION in
  .worktrees|worktrees)
    path="$LOCATION/$BRANCH_NAME"
    ;;
  ~/.config/superpowers/worktrees/*)
    path="~/.config/superpowers/worktrees/$project/$BRANCH_NAME"
    ;;
esac

# 使用新分支创建工作树
git worktree add "$path" -b "$BRANCH_NAME"
cd "$path"

# Node.js
if [ -f package.json ]; then npm install; fi

# Rust
if [ -f Cargo.toml ]; then cargo build; fi

# Python
if [ -f requirements.txt ]; then pip install -r requirements.txt; fi
if [ -f pyproject.toml ]; then poetry install; fi

# Go
if [ -f go.mod ]; then go mod download; fi

运行测试以确保工作树从干净状态开始：

# 示例——使用适合项目的命令
npm test
cargo test
pytest
go test ./...

如果测试失败： 报告失败，询问是继续还是调查。

工作树已就绪：<完整路径>
测试通过（<N> 个测试，0 个失败）
可以开始实现 <功能名称>

.worktrees/ 存在 使用它（验证已被忽略）

worktrees/ 存在 使用它（验证已被忽略）

两者都不存在 检查 CLAUDE.md → 询问用户

目录未被忽略 添加到 .gitignore 并提交

没有 package.json/Cargo.toml 跳过依赖安装

您：我将使用 using-git-worktrees 技能来设置一个隔离的工作区。

[检查 .worktrees/ - 存在]
[验证已忽略 - git check-ignore 确认 .worktrees/ 已被忽略]
[创建工作树：git worktree add .worktrees/auth -b feature/auth]
[运行 npm install]
[运行 npm test - 47 个通过]

工作树已就绪：/Users/jesse/myproject/.worktrees/auth
测试通过（47 个测试，0 个失败）
可以开始实现 auth 功能

本技能适用于执行概述中描述的工作流或操作。

来源说明：本文内容整理自开源项目 agentic-awesome-skills（中文翻译版），遵循 CC BY 4.0（知识共享署名 4.0 国际）许可协议，此处作为中文资料整理分享，版权归原作者所有。

Using Git Worktrees 实用指南

开发工具

编程语言

Git worktrees 允许在共享仓库中创建隔离工作区，无需切换分支即可并行开发。本文提供操作指南：遵循目录优先级（.worktrees > worktrees > CLAUDE.md > 询问），确保项目本地目录被gitignore忽略，自动检测运行项目设置，验证干净测试基线。适用于多分支并行开发场景，避免仓库污染，提升开发效率。

Python

Agent

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

Git worktrees 允许在共享仓库中创建隔离工作区，无需切换分支即可并行开发。本文提供操作指南：遵循目录优先级（.worktrees > worktrees > CLAUDE.md > 询问），确保项目本地目录被gitignore忽略，自动检测运行项目设置，验证干净测试基线。适用于多分支并行开发场景，避免仓库污...

Using Git Worktrees 实用指南

Using Git Worktrees 实用指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐