ccg-workflow Clean-Branches 命令详解：Git 分支安全清理与保护策略实战指南-北京尧图网络

人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek【免费下载链接】ccg-workflow多模型协作开发系统 - Claude 编排 Codex 后端 Gemini 前端28 个命令覆盖开发全流程一键安装零配置项目地址https://gitcode.com/fengshao1227/ccg-workflow点击查看免费下载安全识别并清理已合并或长期未更新的 Git 分支是保持仓库整洁、降低团队协作混乱度的关键日常操作。本文基于 ccg-workflow 开源仓库中 clean-branches.md 命令规范完整讲解/clean-branches的选项语义、四阶段执行工作流、保护分支配置与最佳实践并结合仓库源码命令注册、策略路由、国际化与菜单入口深入解析其底层设计帮助你在 Claude、Codex 等多模型协作开发环境中安全、可控地完成分支清理。命令定位CCG 工作流中的 Git 工具/clean-branches是 ccg-workflow 的 V3 核心命令之一归属于 Git 类别。在 installer-data.ts 中可以看到核心命令core commands始终随项目安装cmd(clean-branches, 22, git, Git 清理分支, Git Clean Branches, 安全清理已合并或过期分支, Safely clean merged or stale branches),其id为clean-branches排序权重order: 22位于commit与worktree之间默认选中defaultSelected: true。这意味着执行npx ccg-workflow安装时该命令会作为 Git 工作流的一部分自动落盘到命令目录随后即可通过/clean-branches斜杠命令直接触发。在 CCG 的智能入口体系里/clean-branches通过 git-action.md 策略被统一路由关键词命令文件说明commit, 提交commit.md智能提交conventional commitrollback, 回滚, revert, undorollback.md交互式回滚clean branch, 清理分支clean-branches.md清理已合并分支worktreeworktree.mdWorktree 管理也就是说无论用户直接敲/clean-branches还是通过/ccg:go说清理分支go.md 的快捷路由规则以clean开头且含branch→ 加载git-action策略最终都会委托给同一份命令规范执行确保两条入口行为完全一致——这正是 git-action 策略不重复实现、直接委托现有命令的铁律体现。使用方法与选项语义命令基本用法/clean-branches [options]完整选项如下选项说明--base branch基准分支默认 main/master--stale days清理超过 N 天未更新的分支--remote同时清理远程分支--dry-run只预览不执行默认--yes跳过确认直接删除--force强制删除未合并分支对选项的语义需要特别强调几点--dry-run是默认模式。命令设计的核心安全理念是先预览、再执行——不带任何参数运行/clean-branches等价于/clean-branches --dry-run只会生成清理报告绝不触碰任何分支。--base决定合并判定的参照系。默认取main/master在多版本并行如 release 分支的仓库中应显式指定例如--base release/v2.1以该分支为基准判定已合并。--stale与--base是两类独立清理维度前者按时间最后提交距今 N 天判定过期后者按合并状态判定两者可以叠加使用。--yes跳过交互确认适合脚本化或 CI 场景--force对应git branch -D可删除未合并分支属于高破坏性操作应谨慎使用。四阶段执行工作流命令的执行被拆分为四个阶段每个阶段都有明确的模式标签准备/分析/报告/执行这与 CCG 的 task 阶段模型analysis → planning → implementation → review → completed一脉相承。阶段 1预检模式准备同步远端git fetch --all --prune读取保护分支配置确定基准分支预检的核心是数据新鲜度通过git fetch --all --prune先同步远端引用并清除已删除的远程跟踪分支确保后续的合并判定与过期判定基于最新状态而不是本地陈旧的引用。阶段 2分析识别模式分析已合并分支已完全合并到--base指定的基准分支的分支。过期分支如指定--stale最后提交在 N 天前的分支。排除从待清理列表中移除保护分支保护分支的具体配置方式见下文。阶段 3报告预览模式报告以 Markdown 报告形式输出将要删除的分支清单分类展示## 将要删除的分支 ### 已合并分支 - feature/old-feature (合并于 3 天前) - bugfix/fixed-issue (合并于 7 天前) ### 过期分支 - experiment/old-test (最后更新 90 天前)报告同时呈现分支名判定依据让清理决策有据可查。此报告在默认 dry-run 模式下即为最终输出在正式执行模式下则作为删除前的最后确认依据。✅ 阶段 4执行清理模式执行仅在不带--dry-run且确认后执行# 本地分支 git branch -d branch # 远程分支如果 --remote git push origin --delete branch # 强制删除如果 --force git branch -D branch注意三种删除方式的语义差异git branch -d是安全删除仅允许删除已合并分支git push origin --delete删除远程分支git branch -D是强制删除不检查合并状态。是否走到这一步取决于--dry-run默认是否被显式关闭以及用户是否确认--yes可跳过确认。保护分支配置给清理上保险保护分支通过 Git config 的branch.cleanup.protected多值键管理支持精确分支名与通配符两种形式# 添加保护分支 git config --add branch.cleanup.protected develop git config --add branch.cleanup.protected release/* # 查看保护分支 git config --get-all branch.cleanup.protected使用--add可以累积多个值--get-all读取全部一个仓库可同时保护develop和所有release/*前缀分支通配符模式让版本分支、发布分支可以整族豁免避免误删长期维护线该配置保存在仓库级.git/config中随仓库迁移团队内共享同一套保护规则。阶段 2 的排除步骤正是读取这些键值将命中保护规则的分支从待清理列表中移除——保护配置是 dry-run 之外的第二道安全闸门。组合示例# 预览将清理的分支 /clean-branches --dry-run # 清理已合并且超过 90 天未动的分支 /clean-branches --stale 90 # 清理已合并到 release/v2.1 的分支 /clean-branches --base release/v2.1 --remote --yes三个示例分别对应三种典型场景日常巡检预览、按时间维度清理--stale 90会同时覆盖已合并与90 天未更新两类分支、以及多版本发布工作流中的定向清理指定--base、连带清理远程、跳过确认。与 CCG 命令生态的集成方式除了上文提到的命令注册installer-data.ts与策略路由git-action.mdclean-branches还在另外两个层面与整个命令体系联动菜单入口在 menu.ts 中/ccg:clean-branches被注册进交互式菜单的帮助描述用户可在npx ccg-workflow的菜单界面中直接看到并触发该命令。多语言支持在 i18n/index.ts 中cleanBranches同时拥有中英文文案中文清理分支 (/ccg:clean-branches)、英文Clean branches (/ccg:clean-branches)说明该命令在安装器、菜单与命令注册层面都遵循 CCG 的中英双语 i18n 约定。从实现结构看clean-branches是规范文档命令注册策略路由菜单入口国际化五层一体中的典型 Git 命令真正执行逻辑由 Claude/Codex 依据 clean-branches.md 规范驱动 Git 完成仓库本身不做重复实现保证了与原生 Git 语义的完全一致。最佳实践优先 dry-run– 先预览再执行。默认模式下运行/clean-branches即完成一次安全的体检确认报告无误后再加--yes正式清理活用 --base– 适配 release 工作流。多版本并行时显式指定--base release/vX.Y避免以 main 为基准误判已合并谨慎 --force– 除非确定无用。git branch -D不可恢复删除前务必通过 dry-run 报告和代码搜索双重确认团队协作– 清理远程分支前先通知。--remote会直接影响团队其他成员的本地引用删除前应在群内或 PR 中公示定期运行– 每月/季度一次保持清爽。把 dry-run 预览纳入例行巡检配合branch.cleanup.protected保护长期分支让仓库始终处于可快速导航的状态。小结/clean-branches体现了 ccg-workflow 在 Git 操作上的核心设计哲学默认安全dry-run、显式授权--yes/--force、可配置保护branch.cleanup.protected、多入口一致斜杠命令与智能路由双通道。它不重复实现 Git 逻辑而是通过规范文档精确约束 AI 的行为边界——这正是多模型协作开发系统中人定规则、AI 执行的典型落地形态。配合 CCG 的 task 追踪task.json 阶段推进与 git-action 策略体系分支清理可以从一次性的手工排查升级为可重复、可审计、团队统一的例行流程。赞分享人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek【免费下载链接】ccg-workflow多模型协作开发系统 - Claude 编排 Codex 后端 Gemini 前端28 个命令覆盖开发全流程一键安装零配置项目地址https://gitcode.com/fengshao1227/ccg-workflow点击查看免费下载相关推荐LeetCode 3410 题解线段树维护最大子段和求解删除所有值为某个元素后的最大子数组和LeetCode 3410 题解线段树维护最大子段和求解删除所有值为某个元素后的最大子数组和本文围绕仓库题解文档 3410. 删除所有值为某个元素后的最大人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeekGel 分支删除实战指南gel branch drop 命令详解与安全删除策略Gel 分支删除实战指南 gel branch drop 命令详解与安全删除策略 gel branch drop 是 GelEdgeDBCLI 中用于永数据库图数据库关系型数据库NOFX 使用指南故障排查、实战最佳实践与核心交易指标全解析NOFX 使用指南故障排查、实战最佳实践与核心交易指标全解析 NOFX 是一款面向美股、大宗商品、外汇与加密货币的 AI 交易终端核心能力是让多个 AI 模人工智能AI 应用开发工具CLIAI Agentdsh-pluginDeepSeek上一篇ThinkPad双风扇智能控制深度解析从噪音困扰到静音享受下一篇终极指南如何使用Polo文件管理器高效管理Linux文件系统创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考

ccg-workflow Clean-Branches 命令详解：Git 分支安全清理与保护策略实战指南

相关推荐

同济版高等数学微分方程一章的总结和理解

使用 Vue Native 构建跨平台原生移动应用：从 CLI 初始化到 React Native 项目集成的完整指南

Vue DevTools v9 双宿主架构与仓库开发指南：一套 Kit、一个 Client、两种宿主（Vite 插件与 Chromium 扩展）

更多资讯

铁路轨道故障图像识别：380张标注数据如何训练YOLO小模型

微信小程序+SSM+MySQL日语词库毕设：从建表到答辩全流程指南

Codejock Xtreme Toolkit Pro v15.3.1 在 VS2017 下的编译与避坑指南

Windows H.264解码库实战：从编译到渲染的完整指南

MFC车型识别与颜色识别：从OpenCV传统视觉到ONNX深度学习落地实践

AI画布交付文件总是混在一起？用源文件、预览图和发布图三层目录分开管理

今日更新

Multisim仿真NE555 PWM控制器：从搭电路到调占空比全流程

S32K312 AUTOSAR BSW开发实战：从配置踩坑到烧录交付

双目视觉三维人脸重建：从视差图到点云粗配准全流程解析

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？