SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

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

主要能力:按优先级选择 worktree 目录,先检查 .worktrees(优先,隐藏)与 worktrees,再读取 AGENTS.md 中的偏好,最后询问用户;对项目本地目录必须用 git check-ignore 验证已被忽略,未忽略则加入 .gitignore 并提交;自动检测并运行项目初始化(如 package.json 执行 npm install、Cargo.toml 执行 cargo build、requirements.txt 执行 pip install -r requirements.txt、pyproject.toml 执行 poetry install、go.mod 执行 go mod download);运行基线测试确认干净起点;报告 worktree 路径与测试结果。

使用方式:开始时声明正在使用该技能;按优先级确定目录;项目本地目录先验证忽略;用 git worktree add "$path" -b "$BRANCH_NAME" 创建并进入;自动运行初始化与测试;测试失败则报告并询问是否继续。

适用场景:功能开发隔离、执行实现计划、子代理驱动开发等需要独立工作区的任务。

限制:项目本地目录未验证忽略会污染 git 状态;测试失败时不应擅自继续;无 package.json 等文件时跳过依赖安装;目录位置不明确时不应假设。该技能常与 finishing-a-development-branch 配合用于完成后清理。