用途:在完成某个功能 worktree 后,安全地将其删除,并清理对应的本地与远程分支。属于 Worktree Lifecycle Suite(/git-worktree、/git-worktree-status、/git-worktree-clean)。
主要能力:脚本会解析目标(可为裸名称如 auth、目录基名如 boss-skills-auth、分支名如 worktree-auth 或完整路径),执行安全检查后删除 worktree、删除分支(本地与远程)并清理引用。具体行为:在受保护分支(main、master、develop、staging、production)上阻止删除;若 worktree 有未提交更改则警告并停止(可用 --force 覆盖);检查合并状态,已合并用 -d、未合并用 -D 删除本地分支;若远程分支存在则删除(除非 --keep-remote);清理过期引用。
使用方式:uv run "${CLAUDE_SKILL_DIR}/scripts/git_worktree_remove.py" <name_or_path> [--force] [--keep-branch] [--keep-remote]。标志:--force 跳过未提交更改保护;--keep-branch 删除 worktree 但保留本地分支;--keep-remote 不删除远程分支。示例:/git-worktree-remove auth;/git-worktree-remove worktree-fix-login --force;/git-worktree-remove boss-skills-experiment --keep-branch。
数据库分支清理:若使用了可分支数据库,需另行删除其分支,参见 ../git-worktree/references/database-branching.md;删除操作不会自动处理数据库。
常见错误:对 main/develop 的 worktree 执行删除会被保护分支检查阻止;未检查就删除未合并分支时脚本会警告,强制前需确认;使用 rm -rf 代替本技能会在 .git/worktrees/ 中留下过期引用。
限制:资料未提供脚本内部实现细节、错误码、依赖版本或平台兼容性说明。