SuperAPI AI 工具集

using-git-worktrees

通用与其它

查看项目

更新于 10-15 17:24

技能介绍

用途:在开始新功能、修 bug 或需要在不 stash 的情况下切换上下文时,用 git worktree 为每个任务创建独立目录,实现分支隔离、保持主分支干净。

主要能力:优先按 .worktrees(隐藏,首选)、worktrees(可见)的顺序查找现有目录;读取 CLAUDE.md 中的 worktree 目录偏好;无目录时向用户提供三种位置选择(.worktrees/、worktrees/、~/.config/superpowers/worktrees/<project-name>/);检查并补充 .gitignore;创建新分支或从已有分支创建 worktree;按语言安装依赖并运行初始测试;提供列出、移除、清理过期 worktree 的命令。

使用方式:查找目录用 ls -d .worktrees 2>/dev/null 与 ls -d worktrees 2>/dev/null;偏好查询用 grep -i "worktree.*director" CLAUDE.md 2>/dev/null;创建用 git worktree add ".worktrees/$BRANCH_NAME" -b "$BRANCH_NAME";依赖安装按 package.json、Cargo.toml、requirements.txt、pyproject.toml、go.mod 判断;管理用 git worktree list、git worktree remove、git worktree remove --force、git worktree prune;同步用 git fetch origin 与 git rebase origin/main。

适用场景:并行开发多个分支、功能与主开发线隔离、避免 stash 切换。

限制与规范:一个 worktree 只对应一个功能,完成后合并并移除,避免堆积;命名建议 feature/descriptive-name、bugfix/issue-number-description、hotfix/critical-issue;若初始测试失败会报告并询问是否继续;资料未提供该技能的收费、平台支持范围等信息。