SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-15 22:13

技能介绍

用途:在开始需要与当前工作区隔离的功能开发,或执行实现计划之前,创建隔离的 Git worktree 工作区。核心原则是系统化目录选择加安全校验,以获得可靠的隔离环境。

主要能力:通过 scripts/worktree-setup <branch-name> 一步完成目录选择、安全校验、依赖安装和基线测试。脚本会自动检测 worktree 目录,优先级为 .worktrees/ > worktrees/ > CLAUDE.md 偏好,并校验该目录是否被 gitignore 忽略。若未自动检测到目录,脚本会退出并给出建议,此时技能会询问用户,再用 --dir <path> 重新运行。

使用方式:运行 scripts/worktree-setup <branch-name>。可用选项包括 --dir <path> 覆盖目录、--no-install、--no-test。退出码含义:0 表示就绪且测试通过,1 表示致命错误,2 表示已创建但测试失败或未找到测试。开始时应声明正在使用该技能设置隔离工作区。

适用场景:需要同时处理多个分支而不切换工作区;执行实现计划前建立隔离环境;与 brainstorming(第 4 阶段)和 plan-execution 配合使用,并与 finishing-a-development-branch 配对,用于工作完成后的清理。

限制与红线:绝不在未验证目录被忽略的情况下创建 worktree(项目本地);不得跳过基线测试验证;不得在测试失败时未经询问就继续;不得假设目录位置。始终遵循目录优先级(已存在 > CLAUDE.md > 询问用户),验证忽略状态,自动检测并运行项目设置,验证干净的测试基线。详细创建步骤、设置命令和示例工作流见 references/creation-steps.md。