source-command-ccg-clean-branches

name	source-command-ccg-clean-branches
description	清理 Git 分支：安全清理已合并或过期分支，默认 dry-run 模式

source-command-ccg-clean-branches

Use this skill when the user asks to run the migrated source command ccg-clean-branches.

Command Template

Clean-Branches - 清理 Git 分支

安全识别并清理已合并或长期未更新的分支。

使用方法

/clean-branches [options]

选项

选项	说明
--base <branch>	基准分支（默认 main/master）
--stale <days>	清理超过 N 天未更新的分支
--remote	同时清理远程分支
--dry-run	只预览，不执行（默认）
--yes	跳过确认直接删除
--force	强制删除未合并分支

---

执行工作流

🔍 阶段 1：预检

[模式：准备]

1. 同步远端：git fetch --all --prune
2. 读取保护分支配置
3. 确定基准分支

📋 阶段 2：分析识别

[模式：分析]

已合并分支：

• 已完全合并到 --base 的分支

过期分支（如指定 --stale）：

• 最后提交在 N 天前的分支

排除：

• 从待清理列表中移除保护分支

📊 阶段 3：报告预览

[模式：报告]

## 将要删除的分支

### 已合并分支
- feature/old-feature (合并于 3 天前)
- bugfix/fixed-issue (合并于 7 天前)

### 过期分支
- experiment/old-test (最后更新 90 天前)

✅ 阶段 4：执行清理

[模式：执行]

仅在不带 --dry-run 且确认后执行：

# 本地分支
git branch -d <branch>

# 远程分支（如果 --remote）
git push origin --delete <branch>

# 强制删除（如果 --force）
git branch -D <branch>

---

保护分支配置

# 添加保护分支
git config --add branch.cleanup.protected develop
git config --add branch.cleanup.protected 'release/*'

# 查看保护分支
git config --get-all branch.cleanup.protected

---

示例

# 预览将清理的分支
/clean-branches --dry-run

# 清理已合并且超过 90 天未动的分支
/clean-branches --stale 90

# 清理已合并到 release/v2.1 的分支
/clean-branches --base release/v2.1 --remote --yes

最佳实践

1. 优先 dry-run – 先预览再执行
2. 活用 --base – 适配 release 工作流
3. 谨慎 --force – 除非确定无用
4. 团队协作 – 清理远程分支前先通知
5. 定期运行 – 每月/季度一次保持清爽