SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-15 23:42

技能介绍

用途:在开始需要与当前工作区隔离的特性开发、或执行实现计划前,创建独立的 Git worktree,使同一仓库可同时在多个分支上工作而无需切换分支。

主要能力:按优先级选择工作树目录——先检查已存在的 .worktrees(首选,隐藏)或 worktrees;两者都存在时用 .worktrees;否则查看 CLAUDE.md 中的 worktree 目录偏好,仍无则询问用户,选项为项目内隐藏目录 .worktrees/ 或全局目录 ~/.config/superpowers/worktrees/<project-name>/。对项目内目录,创建前必须用 git check-ignore 验证目录已被忽略;未忽略时按“立即修复”原则写入 .gitignore 并提交,防止工作树内容被误提交。全局目录无需 .gitignore 校验。

使用方式:用 git rev-parse --show-toplevel 检测项目名;通过 git worktree add "$path" -b "$BRANCH_NAME" 创建新分支工作树并进入;自动检测项目文件运行安装(package.json 用 npm install,Cargo.toml 用 cargo build,requirements.txt 用 pip install -r,pyproject.toml 用 poetry install,go.mod 用 go mod download);运行项目对应测试验证干净基线(如 npm test、cargo test、pytest、go test ./...),通过后报告工作树路径与测试结果。开始时应声明正在使用该技能。

适用场景:需要隔离工作区的特性开发、设计批准后的实现阶段、与执行计划和子智能体开发配合,完成后需与 finishing-a-development-branch 配合清理。

限制与注意:绝不跳过忽略校验与基线测试;测试失败须报告并征求是否继续;目录不明确时不得假设;无对应项目文件则跳过依赖安装。资料未提供具体收费、价格或平台信息。