SuperAPI AI 工具集

nv-worktree-create

编程与开发

查看项目

更新于 11-06 03:07

技能介绍

用途 该技能面向在 novu 仓库中进行多任务并行开发时快速创建隔离工作区的场景。目标是用一个名称同时得到一个新分支和一个位于 ../<name> 的兄弟工作树,创建后即可在其中工作。

输入参数

  • 分支 / 工作树名称:必填,缺失时询问。分支使用原始名称,目录使用经过清理的名称(命名规则见 nv-worktree-commands)。
  • 基准引用(base ref):可选,默认为当前 HEAD。
  • --lite:可选,默认关闭;仅复制核心应用(api、worker、ws、dashboard)的 .env 文件,并跳过工作区脏状态检查。
  • --no-env:可选,默认关闭;完全跳过环境文件复制。
  • --enterprise:可选,默认关闭;额外链接或初始化 enterprise 的 .source 子模块(较慢,涉及网络与符号链接)。

主要步骤

  1. 预检:在主仓库根目录执行 git rev-parse --show-toplevel && git worktree list && git status --porcelain。若目标路径已存在则中止;若工作区状态非空则警告并询问是否继续(--lite 下跳过询问)。
  2. 创建:执行 git worktree add -b <branch> <worktree-path> [<base-ref>],始终创建新分支和新工作树,省略 base-ref 时从当前 HEAD 分叉。
  3. 复制本地环境文件:仅复制被 git 忽略的 .env 文件(.env.* 变体已被跟踪且已存在于工作树中),使用 nv-worktree-commands 中的快速 git ls-files 配方;--lite 使用核心应用配方,--no-env 跳过。不使用递归 rsync,不运行 setup-env-files.js(会重新生成加密密钥),并报告复制内容。
  4. 企业子模块:仅在 --enterprise 时执行,否则以 OSS 模式继续。.source 已存在或已链接时跳过;优先链接已有 packages-enterprise 克隆(候选路径与 .cursor/scripts/install.sh 一致,如 ../packages-enterprise 等);否则在 SSH 不可用时配置 HTTPS git 回退,然后浅初始化 .source;若 .source 可用则刷新符号链接(失败仅警告)。企业设置失败时警告并以 OSS 模式继续,不阻塞工作树。
  5. 交接:以绝对工作树路径调用 move_agent_to_root(不是 move_agent_to_cloned_root)。
  6. 确认:报告分支名称、工作树路径、基准引用、已复制环境文件、企业子模块状态(或“跳过”)。

限制与禁止事项

  • 不检出现有分支,始终新建分支。
  • 不复制整个仓库,只复制 .env。
  • 不运行 pnpm install、pnpm build 或 pnpm setup:agent,即使任务失败也不运行(--enterprise 下的 pnpm symlink:submodules 是唯一允许的 pnpm 脚本)。
  • 不从父检出处符号链接 node_modules。
  • 不在用户未提供(或未确认建议名称)的情况下自行选定分支名称。

示例 用户输入 /worktree branch=more-dcr-oauths 后,分支为 more-dcr-oauths,路径为 ../more-dcr-oauths,执行 git worktree add -b more-dcr-oauths ../more-dcr-oauths,随后复制 .env 并交接;添加 --enterprise 可同时接入 .source 并运行 pnpm symlink:submodules。