用途
recollect-worktree 用于管理 Recollect 开发过程中的 Git worktree。它通过一个管理脚本,在 .worktrees/ 目录下创建隔离的工作环境,方便代码审查、并行功能开发和测试,而无需频繁切换分支。
主要能力
- 从 main 分支创建 worktree,并使用清晰的分支名称。
- 自动复制 .env.local(包含 Supabase/Cloudflare 密钥)。
- 自动运行 pnpm install,使 worktree 具备开发条件。
- 列出、切换和清理 worktree。
使用方式
通过 bash 脚本调用,命令格式如下:
创建 worktree(复制 .env.local,运行 pnpm install):
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-name
列出所有 worktree:
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh list
切换到某个 worktree:
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh switch feature-name
清理不活跃的 worktree:
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh cleanup
创建命令会检查 worktree 是否已存在、从远程更新基础分支、创建新 worktree 和分支、复制 .env.local、运行 pnpm install,并显示 worktree 路径以便 cd 进入。
list 或 ls 列出所有 worktree 及其分支和状态。switch <name> 或 go <name> 切换到已有 worktree。cleanup 或 clean 在确认后移除不活跃的 worktree。
适用场景
- PR 审查:为审查 PR 创建隔离环境。
- 功能开发:并行处理多个功能。
- 测试:在不切换分支的情况下测试功能分支。
工作流示例:
PR 审查:
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create pr-664-lightbox
cd .worktrees/pr-664-lightbox
pnpm run dev
cd ../..
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh cleanup
并行开发:
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-a
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh create feature-b
bash .claude/skills/recollect-worktree/scripts/worktree-manager.sh switch feature-a
在 /work 命令中,会询问工作方式:在当前 worktree 上新建分支(实时工作)或使用 worktree(并行工作)。若选择 worktree,则调用 recollect-worktree 技能。
设计原则
- KISS:一个管理脚本,命令简单,默认值合理。
- 有主见的默认值:默认从 main 创建 worktree,存储在 .worktrees/ 目录,分支名即 worktree 名,自动复制 .env.local,自动运行 pnpm install。
- 安全优先:创建/移除前确认,不会移除当前 worktree,错误信息清晰。
技术细节
目录结构示例:
.worktrees/
├── feature-login/
│ ├── .git
│ ├── .env.local # 从 main 复制
│ ├── node_modules/ # 通过 pnpm 安装
│ └── ...
└── pr-664-lightbox/
└── ...
工作原理:使用 git worktree add 创建隔离环境,每个 worktree 有自己的分支,与主仓库共享 git 历史,轻量(文件系统链接,无重复)。
成功标准
worktree 就绪的条件:.worktrees/<name>/ 目录存在,.env.local 存在于 worktree 中,node_modules/ 存在(pnpm install 完成),pnpm run dev 能成功启动。
限制
资料未提供关于收费、价格、平台支持范围、性能指标或与其他工具集成的更多信息。