SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-16 04:59

技能介绍

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

主要能力:按优先级选择 worktree 目录,先检查 .worktrees(优先)或 worktrees,再查 CLAUDE.md 中的偏好,都没有则询问用户选择项目本地隐藏目录或全局目录 ~/.config/software-forge/worktrees/<project-name>/。对项目本地目录,创建前必须用 git check-ignore -q .worktrees 或 git check-ignore -q worktrees 验证已被忽略;未忽略则加入 .gitignore 并提交。全局目录无需验证。

使用方式:检测项目名 project=$(basename "$(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 requirements.txt,pyproject.toml 执行 poetry install,go.mod 执行 go mod download。再运行项目对应测试(如 npm test、cargo test、pytest、go test ./...)验证干净基线,最后报告路径与测试结果。

适用场景:brainstorming 第 4 阶段设计批准后、subagent-driven-development 与 executing-plans 执行任务前,以及任何需要隔离工作区的技能;完成后与 finishing-a-development-branch 配对清理。

限制:项目本地目录必须验证忽略,否则可能误提交 worktree 内容;测试失败需报告并询问是否继续;无对应项目文件则跳过依赖安装;目录位置不明确时不得假设,须按现有目录、CLAUDE.md、询问用户的优先级处理。