SuperAPI AI 工具集

using-git-worktrees

编程与开发

查看项目

更新于 10-15 22:15

技能介绍

用途:在开始需要与当前工作区隔离的功能开发,或执行实现计划之前,确保存在一个隔离的工作区,避免影响当前分支。

主要能力:先检测是否已处于隔离工作区(通过比较 git rev-parse --git-dir 与 --git-common-dir,并用 git rev-parse --show-superproject-working-tree 排除子模块误判);若已在链接工作区则跳过创建。优先使用平台原生 worktree 工具(如 EnterWorktree、WorktreeCreate、/worktree 命令或 --worktree 标志),无原生工具时才回退到 git worktree add。创建前需征得用户同意,除非已有明确偏好。目录选择优先级:用户指定 > 项目内 .worktrees/ > worktrees/ > 全局 ~/.config/superpowers/worktrees/$project > 默认 .worktrees/。项目内目录必须先用 git check-ignore 验证已被忽略,否则加入 .gitignore 并提交。创建后自动检测并运行项目安装(npm install、cargo build、pip install -r requirements.txt、poetry install、go mod download),再运行基线测试(npm test、cargo test、pytest、go test ./...)。

使用方式:按步骤执行——Step 0 检测隔离,Step 1a 原生工具,Step 1b git 回退,Step 3 项目设置,Step 4 基线验证。若 git worktree add 因沙箱权限失败,则告知用户并在当前目录继续。

限制:不得在已检测到隔离时重复创建工作区;有原生工具时不得使用 git worktree add;项目内目录未验证忽略前不得创建;基线测试失败需报告并询问是否继续,不得擅自推进。