用途:为并行功能开发创建隔离的 git worktree,自动进行分支命名并配置环境文件。
主要能力:通过 node .claude/scripts/worktree.cjs info --json 检测仓库类型(monorepo 或 standalone)、基础分支、monorepo 项目列表、.env* 文件与脏状态;根据描述关键词推断前缀(fix、refactor、docs、test、chore、perf,其余为 feat);将描述转换为 kebab-case slug(最多 50 字符);执行创建、移除、查看信息与列出工作树。
使用方式:先运行 info 获取仓库信息;若为 monorepo 且未指定项目,需向用户确认项目;始终询问要复制哪些环境文件。创建命令格式:monorepo 为 node .claude/scripts/worktree.cjs create "<PROJECT>" "<SLUG>" --prefix <TYPE> --env "<FILES>",standalone 为 node .claude/scripts/worktree.cjs create "<SLUG>" --prefix <TYPE> --env "<FILES>"。支持 --prefix、--env、--json、--dry-run。其他命令为 remove <name-or-path>、info、list。
适用场景:需要隔离工作区进行并行开发、按功能类型规范分支命名、为新工作树准备环境文件的 Git 项目,尤其适合 monorepo。
限制与注意事项:本文档主要包含项目级协议与提示,具体脚本实现细节、支持的 Git 版本、平台兼容性、创建后的目录约定细节暂未提供。错误码包括 MISSING_ARGS、MISSING_FEATURE、PROJECT_NOT_FOUND、MULTIPLE_PROJECTS_MATCH、MULTIPLE_WORKTREES_MATCH、BRANCH_CHECKED_OUT、WORKTREE_EXISTS、WORKTREE_CREATE_FAILED、WORKTREE_REMOVE_FAILED,需按提示处理。文档强调先建立任务跟踪、证据引用与不臆测事实。