SuperAPI AI 工具集

worktree

通用与其它

查看项目

更新于 10-15 21:55

技能介绍

用途:为每个 issue 或 PR 创建独立的 git worktree,实现隔离开发,避免在主仓库中直接改动。

主要能力:包含三个子操作,分别对应创建单个 worktree、交互式移除指定 worktree、批量清理已完成 worktree。创建时按约定生成路径与分支:路径为 ../<reponame>-issue-<num>-<title-slug>/,位于源仓库同级而非内部;分支名为 issue-<num>-<title-slug>,标题 slug 取自 gh issue view --json title,转为小写字母数字加连字符。分支以 issue-<NUM>- 前缀作为可信 issue 标记。默认分支通过 git remote show origin | grep 'HEAD branch' 获取,兼容 main、master 或自定义分支。状态文件 ${CLAUDE_PLUGIN_ROOT}/scripts/worktree-state.sh 会注册活动 worktree,使 pre-tool-use 钩子阻止误改源仓库。

使用方式:根据用户意图选择对应子文件与斜杠命令——创建用 create.md 与 /create-worktree <num>,移除用 remove.md 与 /remove-worktree,批量清理用 prune.md 与 /prune-worktree。

前提条件:需安装并认证 gh CLI,且从 git 仓库内运行(任意 worktree 均可,不限于主检出)。

限制:移除操作含交互选择与安全检查(issue 是否关闭、分支是否合并、是否有未提交改动);批量清理需评估、分类、确认后移除。具体实现细节以对应子文件为准。