用途:删除远程跟踪分支已被删除的本地分支,并处理这些分支关联的 worktree。
主要能力:先执行 git fetch --prune 获取最新远程状态,再解析 git branch -vv 中标记为 : gone] 的分支,找出已失效的本地分支;确认后逐个删除,若分支存在关联 worktree 且不是主仓库根目录,则先移除 worktree 再删除分支。
使用方式:第一步运行发现脚本 bash scripts/clean-gone,脚本会先执行 git fetch --prune,再解析 git branch -vv。若脚本输出 NONE,说明没有陈旧分支,报告后停止。第二步向用户列出将删除的分支并请求确认,使用平台阻塞式提问工具:Claude Code 用 AskUserQuestion(若 schema 未加载先调用 ToolSearch 并 select:AskUserQuestion),Codex 用 request_user_input,Gemini 用 ask_user,Pi 用 ask_user(需 pi-ask-user 扩展);仅当运行环境没有阻塞式工具或调用报错时才回退到聊天中提问,不得静默跳过确认。这是针对整个列表的是/否决定,不提供多选或逐分支选择。第三步在用户确认后删除:先用 git worktree list | grep "[$branch]" 检查关联 worktree,若存在且非主仓库根目录,先执行 git worktree remove --force "$worktree_path",再执行 git branch -D "$branch",并逐条报告结果。若用户拒绝,则确认并停止,不删除任何内容。
适用场景:本地积累了大量远程已删除的分支,需要批量清理并同步 worktree 时。
限制:依赖 git 与脚本环境;删除为强制操作(-D、--force),需用户确认;具体平台工具支持情况取决于运行环境。