SuperAPI AI 工具集

recollect-worktree

编程与开发

查看项目

更新于 10-16 02:25

技能介绍

用途

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 能成功启动。

限制

资料未提供关于收费、价格、平台支持范围、性能指标或与其他工具集成的更多信息。