# worktree

**Repository Path**: touchx_admin/worktree

## Basic Information

- **Project Name**: worktree
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-02-25
- **Last Updated**: 2026-02-25

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Git Worktree 最佳实践学习资源

> 掌握 Git Worktree 和 Claude Code CLI 的强大功能,实现高效的并行开发

## 📖 项目简介

本项目是一套完整的学习资源,帮助开发者掌握 Git Worktree 和 Claude Code CLI Worktree 功能,提升并行开发效率。

### 学习内容

- **Git Worktree 基础**: 理解核心概念和工作原理
- **基本操作**: 创建、管理和清理 Worktree
- **Claude Code CLI 集成**: 使用 `--worktree` 标志和 Desktop 自动隔离
- **Sub-agent 隔离**: 配置并行 AI 任务的安全隔离
- **最佳实践**: 何时使用、常见陷阱和高级技巧

## 🚀 快速开始

### 前置要求

- Git 2.19.0 或更高版本
- Claude Code CLI 2.1.50 或更高版本(可选)
- 基本的 Git 分支、提交、合并知识

### 5 分钟入门

```bash
# 1. 验证环境
git --version  # 需要 >= 2.19.0
claude --version  # 需要 >= 2.1.50

# 2. 创建第一个 Worktree
git worktree add ../my-feature main

# 3. 使用 Claude Code CLI 启动隔离会话
claude --worktree my-feature
```

详细入门指南: [docs/quickstart.md](docs/quickstart.md)

## 📚 学习路径

### 模块 1: Git Worktree 基础概念 ⭐ 建议首先学习

**时间**: 10-15 分钟 | **难度**: 初学者

- 理解 Worktree 是什么
- 与传统分支切换的区别
- 适用场景和优势劣势

👉 [开始学习](docs/01-concepts.md)

---

### 模块 2: 创建和管理 Worktree

**时间**: 15-20 分钟 | **难度**: 初学者

- 创建、列出和删除 Worktree
- Worktree 间切换
- 配置和管理

👉 [开始学习](docs/02-basics.md)

---

### 模块 3: Claude Code CLI 集成

**时间**: 20-30 分钟 | **难度**: 中级

- `--worktree` 标志使用
- Desktop 自动隔离
- Sub-agent Worktree 隔离

👉 [开始学习](docs/03-claude-integration.md)

---

## 🎓 实践练习

渐进式练习路径,从简单到复杂:

| 练习 | 级别 | 时间 | 描述 |
|------|------|------|------|
| [Exercise 1](docs/exercises/exercise-01-basic-worktree.md) | Level 1 | 10 分钟 | 单命令基础操作 |
| [Exercise 2](docs/exercises/exercise-02-multi-session.md) | Level 2 | 20 分钟 | 多会话并行工作 |
| [Exercise 3](docs/exercises/exercise-03-subagent-isolation.md) | Level 3 | 30 分钟 | Sub-agent 隔离 |

## 📋 快速参考

- [决策矩阵](docs/reference/decision-matrix.md) - 何时使用 Worktree
- [命令参考](docs/reference/commands.md) - 常用命令速查
- [故障排除](docs/reference/troubleshooting.md) - 常见问题解决

## 🎯 学习成果

完成所有模块后,你将能够:

- ✅ 在 10 分钟内解释 Git Worktree 核心概念
- ✅ 在 5 分钟内创建新 Worktree
- ✅ 正确管理所有活跃的 Worktree
- ✅ 在两个不同 Worktree 中并行开发
- ✅ 独立解决 80%+ 的常见问题
- ✅ 90%+ 准确判断是否使用 Worktree

## 📁 项目结构

```
git-tree/
├── docs/                           # 学习资源主目录
│   ├── README.md                   # 学习资源导航
│   ├── quickstart.md               # 5分钟快速入门
│   ├── 01-concepts.md              # 模块1: 基础概念
│   ├── 02-basics.md                # 模块2: 基本操作
│   ├── 03-claude-integration.md    # 模块3: Claude集成
│   ├── exercises/                  # 实践练习
│   ├── checklists/                 # 自检清单
│   ├── reference/                  # 快速参考
│   └── examples/                   # 可执行示例
├── specs/                          # 项目规范和计划
└── README.md                       # 本文件
```

## 🛠️ 技术栈

- **文档格式**: Markdown (CommonMark/GitHub Flavored)
- **版本要求**: Git 2.19.0+, Claude Code CLI 2.1.50+
- **平台**: 跨平台 (Linux, macOS, Windows)

## 📖 使用指南

### 开始学习

1. 阅读 [快速入门指南](docs/quickstart.md)
2. 按顺序完成模块 1-3
3. 完成配套练习巩固知识
4. 使用快速参考查阅命令

### 贡献指南

欢迎反馈和改进建议!

### 许可证

本项目是学习资源项目,基于项目功能规范创建。

## 🔗 相关资源

- [Git Worktree 官方文档](https://git-scm.com/docs/git-worktree)
- [Claude Code 文档](https://claude.ai/code)
- [Claude Worktree 指南](https://claudefa.st/blog/guide/development/worktree-guide)

---

**开始学习**: [模块 1: Git Worktree 基础概念](docs/01-concepts.md) 🚀