git-branch-cleanup
分析并安全清理本地 Git 分支,提供交互式分类、安全防护与工作树 (worktree) 支持。
简介
git-branch-cleanup 是一个专为开发人员与 DevOps 工程师设计的工具,旨在维护整洁的本地开发环境。随着时间推移,本地 Git 存储库往往会积累过时、已合并或孤立的分支,这会使开发工作流程变得混乱并增加认知负担。此技能通过根据分支与基础分支(如 main 或 master)的关系、最后提交活动以及远程追踪状态进行分类,自动执行这些分支的识别与安全移除。
-
将分支分为特定类别:已合并(安全删除)、远程已删除(gone)、过时(30 天以上无活动)、未合并(进行中)以及与 Git 工作树相关联的分支。
-
实施严格的安全防护机制,防止删除 main、master、trunk 等关键分支及当前检出的分支。
-
提供交互式分步骤工作流程:分析当前状态、审核安全分类、确认删除并执行清理。
-
支持高级 Git 功能,包括检测与正确管理 git worktree 关联,以避免删除过程中导致文件系统损坏。
-
具备预览删除(Dry Run)模式,用户可在执行任何指令前预览删除结果,确保对存储库维护的完全掌控。
-
利用标准 Git 指令(如 for-each-ref、branch --merged 及 branch -vv)确保在标准 Git 环境下的可靠性。
-
推荐给管理大型存储库或遵循敏捷开发工作流程(频繁产生功能分支)的开发者使用。
-
此工具需具备 Git 2.17+ 以获得完整工作树支持,建议 Git 2.22+ 以获得最佳分支识别能力。
-
常见使用场景包括:合并后清理分支、移除链接至已删除远程 PR 的分支,以及识别长期遗忘的实验性分支。
-
用户需注意,「过时」门槛是可配置的;默认的 30 天窗口可根据特定团队的冲刺(Sprint)周期或项目需求进行调整。
-
该技能区分了针对已合并分支的「git branch -d」安全删除,以及针对未合并或孤立分支的强制「-D」删除,并提供何时使用何者清楚的指导。
仓库统计
- Star 数
- 382
- Fork 数
- 26
- Open Issue 数
- 3
- 主要语言
- Python
- 默认分支
- main
- 同步状态
- 空闲
- 最近同步时间
- 2026年5月1日 07:05