SuperAPI AI 工具集

worktree

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:管理 Git worktree 的创建、状态查询与清理,统一存放位置为 ~/Documents/<repo>-<name>。子指令由参数解析:空或 status 为状态,create <name> 为创建,cleanup 为清理,prune 为清理孤立元数据。所有子指令先通过 git rev-parse --show-toplevel 与 basename 获取仓库信息,不在 git 仓库中会提示切换目录。

主要能力:status 用 git worktree list --porcelain 列出非主 worktree,结合 gh pr list 查询 PR 状态、du -sh 统计磁盘用量,并标记标准路径、[legacy]、[non-standard]、[orphan],输出表格与清理提示。create 计算路径与分支名 worktree-<name>,检查路径和分支是否已存在,询问 base branch 后执行 git worktree add -b worktree-<name> ~/Documents/<repo>-<name> <base-branch>,并提示用 cd 与 claude 开新会话。cleanup 检测 MERGED/CLOSED PR 或已合并分支,检查脏目录,经确认后执行 git worktree remove,只移除目录不删分支;跨仓库批量可调用 ~/Documents/agent-skills/scripts/worktree-cleanup.sh,默认 dry-run,需 --fetch --apply 才动作,另有 --du、--kill-blockers、--root 选项。prune 执行 git worktree prune 清理孤立元数据。

限制:gh 查询失败或为空时标记 [unknown] 仍列入候选;dirty worktree 默认跳过;删除后重新列出验证,失败提示手动 prune;不删除分支,除非用户明确要求且仅用 git branch -d 并跳过长期分支。资料未提供安装方式、收费与平台信息。