SuperAPI AI 工具集

git-worktree

通用与其它

查看项目

更新于 10-15 21:53

技能介绍

用途:当用户要求新建 git worktree、独立分支目录或隔离工作区,或当前检出存在无关本地改动、需要并行处理多个任务时,该技能会实际创建 worktree,而不是只给建议。

主要能力:从当前检出读取仓库信息(git rev-parse --show-toplevel、git branch --show-current、git status --short、git worktree list --porcelain);根据任务推导 ASCII kebab-case 短 slug;默认分支前缀为 worktree/,默认目录为仓库根目录同级的 <repo-name>-<slug>;分支或路径已存在时自动递增;默认以 HEAD 为基准,避免带入未提交改动。

使用方式:用内联 git 与 shell 命令创建,不引入辅助脚本。创建后把新路径视为后续任务的活跃工作目录:后续命令针对该路径执行,编辑也落在该路径下,并至少运行一次后续命令确认交接,例如 pwd、git status --short --branch。若环境支持按命令指定工作目录则逐条使用,否则用 cd <worktree_path> && ... 前缀。

限制与规则:目录不是 Git 仓库时明确说明,不假装已创建;创建因权限失败时请求最小授权后重试;不静默 stash、reset 或移动用户已有改动;若需把本地改动带入新 worktree,需显式使用临时提交、补丁或 cherry-pick 并说明;仅在用户要求或清理属于任务时删除 worktree,且绝不删除用户原始检出。创建成功后应继续用户的实际任务,而非停在初始化。