SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-15 21:36

技能介绍

用途:在开始需要与当前工作区隔离的功能开发,或执行实现计划之前,创建隔离的 Git worktree 工作区。Git worktree 共享同一仓库,可同时处理多个分支而无需切换。核心原则是系统化目录选择加安全校验,保证隔离可靠。

主要能力:按优先级选择 worktree 目录,先检查现有 .worktrees 或 worktrees 目录,两者都存在时优先 .worktrees;再检查 CLAUDE.md 中的 worktree 目录偏好;都没有时询问用户,可选项目内隐藏目录 .worktrees/ 或全局位置 ~/.claude/worktrees/<project-name>/。创建时用 git worktree add "$path" -b "$BRANCH_NAME" 新建分支并进入目录。随后自动检测并运行项目初始化,如 package.json 执行 npm install、Cargo.toml 执行 cargo build、requirements.txt 执行 pip install -r requirements.txt、pyproject.toml 执行 poetry install、go.mod 执行 go mod download。最后运行项目测试验证干净基线,并报告路径与测试结果。

使用方式:开始时声明正在使用该技能设置隔离工作区。对项目内目录,创建前必须用 grep 检查 .gitignore 是否包含对应目录模式,若没有则添加并提交,防止 worktree 内容被误提交。全局目录无需 .gitignore 校验。测试失败时报告失败并询问是否继续或调查;测试通过则报告就绪。

适用场景:功能开发隔离、执行实现计划、任何需要独立工作区的技能。与 finishing-a-development-branch 配合用于完成后清理,被 brainstorming 等技能调用。

限制与注意:不要跳过 .gitignore 校验、基线测试验证或 CLAUDE.md 检查;不要在测试失败时未经询问继续;不要硬编码初始化命令,应依据项目文件自动检测;目录不明确时不要假设位置。