tangchunwu source-command-ccg-worktree
Use this skill when the user asks to run the migrated source command ccg-worktree.
Command Template
Worktree - Git Worktree 管理
在结构化目录管理 Git worktree，支持智能默认和 IDE 集成。
使用方法
/worktree <add|list|remove|prune|migrate> [options]
子命令
| 命令 | 说明 |
|---|---|
add <path> |
创建新 worktree |
list |
列出所有 worktree |
remove <path> |
删除指定 worktree |
prune |
清理无效引用 |
migrate <target> |
迁移内容到目标 worktree |
选项
| 选项 | 说明 |
|---|---|
-b <branch> |
创建新分支 |
-o, --open |
创建后用 IDE 打开 |
--from <source> |
迁移源路径 |
--stash |
迁移 stash 内容 |
--track |
跟踪远程分支 |
--detach |
分离 HEAD |
--lock |
锁定 worktree |
目录结构
parent-directory/
├── your-project/ # 主项目
│ ├── .git/
│ └── src/
└── .ccg/ # worktree 管理目录
└── your-project/
├── feature-ui/ # 功能分支
├── hotfix/ # 修复分支
└── debug/ # 调试 worktree
执行工作流
Add - 创建 Worktree
[模式：创建]
- 验证 Git 仓库
- 计算路径：
../.ccg/项目名/<path> - 创建 worktree
- 自动复制环境文件（
.env等） - 可选：用 IDE 打开
Migrate - 迁移内容
[模式：迁移]
- 验证源有未提交内容
- 确保目标干净
- 显示即将迁移的改动
- 安全迁移
- 确认结果
示例
# 基本创建
/worktree add feature-ui
# 创建并用 IDE 打开
/worktree add feature-ui -o
# 创建指定分支
/worktree add hotfix -b fix/login -o
# 迁移未提交内容
/worktree migrate feature-ui --from main
# 迁移 stash 内容
/worktree migrate feature-ui --stash
# 管理操作
/worktree list
/worktree remove feature-ui
/worktree prune
输出示例
✅ Worktree created at ../.ccg/项目名/feature-ui
✅ 已复制 .env
✅ 已复制 .env.local
📋 已从 .gitignore 复制 2 个环境文件
🖥️ 是否在 IDE 中打开？[y/n]: y
🚀 正在用 VS Code 打开...
智能特性
- 智能默认 – 未指定分支时使用路径名
- IDE 集成 – 自动检测 VS Code / Cursor / WebStorm
- 环境文件 – 自动复制
.gitignore中的.env文件 - 路径安全 – 始终使用绝对路径防止嵌套问题
- 分支保护 – 验证分支未被其他地方使用
注意事项
- Worktree 共享
.git目录，节省磁盘空间 - 迁移仅限未提交改动，已提交内容用
git cherry-pick - 支持 Windows、macOS、Linux