用途:删除远程跟踪分支已被删除的本地分支,并清理这些分支关联的 worktree。当用户说 clean up branches、delete gone branches、prune local branches 等时使用。
主要能力与用法:
- 发现:运行 bash scripts/clean-gone。脚本先执行 git fetch --prune,再从 git branch -vv 中解析标记为 : gone] 的分支。如果脚本输出 NONE,说明没有可清理分支,停止并告知用户。
- 确认:向用户展示将要删除的分支列表,等待用户回答。优先使用平台的提问工具,例如 Claude Code 的 AskUserQuestion、Codex 的 request_user_input、Gemini 的 ask_user;没有提问工具时直接展示列表并等待回复。这是针对整个列表的是/否确认,不提供多选或逐分支选择。
- 删除:用户确认后,逐个处理。先用 git worktree list | grep "[$branch]" 检查是否有关联 worktree;若存在且不是主仓库根目录,先执行 git worktree remove --force "$worktree_path",再执行 git branch -D "$branch"。执行过程中报告结果,例如“Removed worktree: .worktrees/feature/old-thing”“Deleted branch: feature/old-thing”,最后汇总清理数量。若用户拒绝,则确认后停止,不删除任何内容。
适用场景:本地积累了大量远程已删除分支,需要按确认流程安全批量清理时。
限制:仅处理远程跟踪分支标记为 gone 的本地分支;删除前必须获得用户整体确认;依赖 git 环境与提供的脚本。其他平台或收费信息暂未提供。