用途:安全清理本地累积的 Git 分支与 worktree。它把分支归类为可安全删除(已合并)、squash 合并、被取代(superseded)、远端已删除([gone])、未推送工作、本地独有工作、与远端同步等,并给出删除建议。仅限本地清理,不管理远端分支,也不做 gc、prune 等仓库维护,且需要用户在两个确认关卡交互确认,不适合无人值守自动化。
主要能力:先做全面分析,获取默认分支名、受保护分支(main、master、develop、release/*)、git branch -vv、git worktree list、git fetch --prune、git branch --merged 及近期 PR 合并历史;再按名称前缀把相关分支分组,结合提交历史与 PR 证据判断是否被取代;随后逐类归类,并检测各 worktree 与当前目录的未提交改动。
使用方式:仅在用户显式调用 /git-cleanup 时运行。第一关展示完整分析(分组、分类、worktree 状态、汇总),由用户选择清理范围;第二关展示将执行的确切命令并确认。执行时逐条运行删除命令,单条失败不影响其余,最后报告已删除与剩余分支。
关键规则:已合并分支用 git branch -d;squash 合并或被取代分支必须直接用 git branch -D,因为 git branch -d 对 squash 合并必然失败,这是预期行为。受保护分支永不分析或删除。存在未提交改动的 worktree 必须明确确认数据丢失后才可移除。
限制:不做远端分支管理;不替代仓库维护;需要交互确认;被取代判定需 PR 或提交包含关系作为证据,仅名称前缀相同不足以判定。