SuperAPI AI 工具集

using-git-worktrees

通用与其它

查看项目

更新于 10-16 07:19

技能介绍

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

主要能力:按优先级确定 worktree 目录——先检查现有 .worktrees(首选)或 worktrees 目录,两者同时存在时用 .worktrees;否则查看 CLAUDE.md 中的偏好;都没有才询问用户,可选项目内隐藏目录 .worktrees/ 或全局位置 ~/.config/quirk/worktrees/<项目名>/。对项目内目录必须先验证已被 gitignore 忽略,使用 git check-ignore -q .worktrees 或 git check-ignore -q worktrees;若未被忽略,则向 .gitignore 添加相应行并提交,防止 worktree 内容被误提交。

使用方式:先检测项目名 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、subagent-driven-development、executing-plans 等流程要求调用,并与 finishing-a-development-branch 配合完成收尾。

适用场景:需要在不切换当前分支的情况下并行开发多个分支、执行实施计划前搭建干净环境。

限制与常见错误:若跳过忽略验证,worktree 内容会被跟踪并污染 git 状态;不应假设目录位置,应遵循现有目录大于 CLAUDE.md 大于询问的优先级;测试失败时不应未经许可继续,否则难以区分新缺陷与既有问题;不要硬编码初始化命令,而应依据项目文件自动检测。资料未说明具体收费、平台或额外效果。