SuperAPI AI 工具集

clean-gone

编程与开发

查看项目

更新于 11-10 16:22

技能介绍

用途:clean-gone 用于清理本地仓库中远程已被删除、但本地仍然保留的分支(在 git branch -v 中标记为 [gone]),同时处理这些分支所关联的 worktree,避免残留目录和失效分支堆积。

主要能力:

  1. 通过 git branch -v 列出本地分支及其状态,识别带 [gone] 标记的分支;带 '+' 前缀的分支表示存在关联 worktree,需要先移除 worktree 再删除分支。
  2. 通过 git worktree list 定位 [gone] 分支对应的工作树路径。
  3. 在一个循环中逐条处理所有 [gone] 分支:若存在关联 worktree 且不是当前仓库根目录,则执行 git worktree remove --force 强制移除;随后执行 git branch -D 强制删除该分支;过程中输出正在处理的 branch、移除的 worktree 与删除的 branch。
  4. 若无 [gone] 分支,脚本不会删除任何内容,并报告无需清理。

使用方式:该技能本质上是一组需要依次执行的 bash 命令。先运行 git branch -v 查看分支状态,再运行 git worktree list 查看工作树;最后执行给定的 while 循环命令完成移除与删除。资料未提供安装方式、调用入口或参数配置,暂未提供。

适用场景:本地长期开发后远程分支被合并删除、需要批量清理失效本地分支时;使用 git worktree 多目录并行开发、需要同步清理关联工作树时。

限制与注意:脚本使用 git branch -D 强制删除与 git worktree remove --force 强制移除,属于不可逆操作,执行前应确认 [gone] 分支不再需要;命令依赖 grep、sed、awk 等 Unix 工具环境;若 worktree 路径等于当前仓库根目录则跳过移除,仅删除分支。资料未说明对非 Unix 环境、异常退出码或权限问题的处理,暂未提供。