SuperAPI AI 工具集

git-branch-cleanup

通用与其它

查看项目

更新于 10-16 05:49

技能介绍

用途:该技能用于分析本地 Git 分支,并按合并状态、陈旧程度与远程跟踪情况分类,从而安全地清理无用分支。

主要能力:

  1. 分支分析:识别基准分支(优先自动检测 origin/HEAD,回退到 main),列出所有分支及其最后提交时间、上游跟踪状态与提交主题;区分已合并、未合并、远程已删除(gone)、30 天以上未提交的陈旧分支。
  2. 安全检查:识别带 worktree 的分支(git branch -v 中带 + 前缀)、领先于上游(存在未推送提交)的分支。
  3. 分类展示:按安全等级分组显示,并提供选项让用户选择删除范围(仅已合并、已合并加远程已删除、逐个选择)。
  4. 删除执行:确认后对已合并分支用 git branch -d,未合并用 git branch -D。对带 worktree 的分支先执行 git worktree remove --force 再删除。

使用方式:按工作流执行——先分析,再分类,展示结果并询问用户,通过安全守卫校验,最后确认后删除。用户可要求 --dry-run、preview 或 just show me 触发只预览不执行模式。可用 git fetch --prune 清理远程跟踪引用(需网络,失败可跳过)。

限制与安全约束:绝不删除 main、master、trunk、develop、development 以及当前所在分支;删除前始终要求用户确认;不得删除领先于上游、含未推送提交的分支;带 worktree 的分支需先移除 worktree。陈旧阈值默认 30 天,可按团队迭代周期调整。