企业级 Git 工作流方案,支持 Git Flow、团队协作、冲突工具集成与批量分支管理。
Git 工作流助手(专业版)是一项面向实际任务的技能,主要用于本工具面向中大型研发团队,提供企业级 Git 工作流治理方案;在免费版基础能力之上,专业版引入 Git Flow / GitHub Flow / GitLab Flow 三大工作流模型的完整落地指引,支持多分支并行管理、批量分支操作、冲突自动记忆(rerere)、发布分支管理与版本标签策略;
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
本工具面向中大型研发团队,提供企业级 Git 工作流治理方案。在免费版基础能力之上,专业版引入 Git Flow / GitHub Flow / GitLab Flow 三大工作流模型的完整落地指引,支持多分支并行管理、批量分支操作、冲突自动记忆(rerere)、发布分支管理与版本标签策略。通过结构化流程与自动化脚本,帮助团队建立统一的版本控制规范,降低协作冲突,提升发布效率。
版本兼容性说明:专业版完全兼容免费版(git-workflow-cn-tool-free)的所有命令与规范,可无缝升级。
| 能力模块 | 免费版 | 专业版新增 |
|---|---|---|
| 分支管理 | 基础创建/切换/合并 | 批量分支管理、保护分支策略 |
| 工作流模型 | - | Git Flow / GitHub Flow / GitLab Flow |
| 冲突解决 | 手动解决 | rerere 自动记忆 + 三方对比工具 |
| 提交规范 | Conventional Commits | CHANGELOG 自动生成 + 语义化版本 |
| 发布管理 | - | 发布分支、版本标签、回滚策略 |
| 团队协作 | - | 代码审查流程、合并请求规范 |
技术实现要点:核心能力基于input_params参数与output_format配置实现,支持创建/查询/修改/删除等操作模式,通过config_options进行运行时配置。 |
用input_params参数进行配置。
输入: 用户提供核心功能执行所需的指令和必要参数。 处理: 按照skill规范执行核心功能执行操作,遵循单一意图原则。 输出: 返回核心功能执行的执行结果,包含操作状态和输出数据。
input_params参数,支持创建/查询/导出操作用config_options参数进行配置。
输入: 用户提供参数配置与调用所需的指令和必要参数。 处理: 按照skill规范执行参数配置与调用操作,遵循单一意图原则。 输出: 返回参数配置与调用的执行结果,包含操作状态和输出数据。
config_options参数,支持修改/重置/导入操作用output_format参数进行配置。
输入: 用户提供结果处理与输出所需的指令和必要参数。 处理: 按照skill规范执行结果处理与输出操作,遵循单一意图原则。 输出: 返回结果处理与输出的执行结果,包含操作状态和输出数据。
output_format参数,支持导出/保存/转换操作
能力覆盖范围:本skill的核心能力覆盖以下场景关键词:企业级、工作流方案、冲突工具集成与批、面向团队协作与企、业研发场景的、工作流专业工具、Use、when、需要提升效率、自动化流程、批量处理、工作流优化时使用、不适用于需要人工、创意判断的任务、适用于独立开发者、企业团队和自动化、工作流场景等。这些关键词对应description中声明的使用场景,均已在上述能力点中提供对应的操作支持。团队需要规划一个正式版本发布,包含功能开发、预发布验证、紧急修复全流程。
用户:我们需要发布 v2.0.0 版本,包含多个功能分支,帮我规划 Git Flow 流程 助手: 1. 初始化 Git Flow git flow init 2. 功能分支开发(多个并行) git flow feature start user-auth git flow feature start payment-module # 开发完成后分别完成 git flow feature finish user-auth git flow feature finish payment-module 3. 创建发布分支 git flow release start v2.0.0 # 在发布分支上仅允许修复缺陷和文档更新 4. 完成发布并打标签 git flow release finish v2.0.0 # 自动合并到 main 和 develop,并打版本标签 5. 推送所有分支和标签 git push origin --all git push origin --tags 6. 紧急修复流程(如线上发现缺陷) git flow hotfix start fix-login-crash v2.0.0 # 修复完成后 git flow hotfix finish fix-login-crash
团队需要维护开发、预发、生产三个环境的代码同步。
用户:我们有 dev/staging/prod 三个环境,怎么管理分支 助手:推荐 GitLab Flow 模式 1. 功能分支开发并合并到 main git checkout -b feature/payment main git push origin feature/payment # 通过合并请求合并到 main 2. main 合并到 staging 部署预发 git checkout staging git merge main git push origin staging 3. staging 验证通过后合并到 production git checkout production git merge staging git push origin production 4. 紧急修复需要从 production 反向合并 git checkout -b hotfix/urgent production # 修复后合并回 production 和 main
项目积累了大量过期分支,需要批量清理并启用冲突自动记忆。
# 启用 rerere 自动记忆冲突解决方案
git config --global rerere.enabled true
# 批量查看已合并分支
git branch --merged main | grep -v "^*|main|develop"
# 批量删除已合并的本地分支
git branch --merged main | grep -v "^*|main|develop" | xargs -n 1 git branch -d
# 批量清理远程过期分支
git remote prune origin
git fetch --all --prune
# 批量删除远程已合并分支(谨慎操作)
git branch -r --merged origin/main | grep -v "main|develop" | sed 's/origin///' | xargs -I{} git push origin :{}
# 依赖说明 brew install git-flow # 安装 git-flow(Ubuntu/Debian) apt-get install git-flow # 初始化项目 git flow init # 自定义分支名(交互式配置) # main branch: main # develop branch: develop # feature/: feature/ # release/: release/ # hotfix/: hotfix/
# 启用冲突自动记忆 git config --global rerere.enabled true # 配置三方合并工具 git config --global merge.tool vscode git config --global mergetool.vscode.cmd 'code --wait $MERGED' # 配置行尾换行符 git config --global core.autocrlf input # 配置拉取策略为 rebase git config --global pull.rebase true # 配置推送默认行为 git config --global push.default current # 启用部分克隆(大仓库优化) git config --global feature.experimental true
结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,查阅错误处理章节获取恢复步骤。
-I: 命令参数,用于指定操作选项-qE: 命令参数,用于指定操作选项| 分支 | 保护规则 | 合并方式 | 谁可推送 |
|---|---|---|---|
| main | 禁止直接推送 | 合并请求 + 审查 | 仅管理员 |
| develop | 禁止直接推送 | 合并请求 | 核心成员 |
| release/* | 禁止新功能 | 仅缺陷修复 | 发布负责人 |
| hotfix/* | 紧急通道 | 快速审查 | 值班人员 |
| feature/* | 自由推送 | 直接推送 | 分支创建者 |
# 语义化版本标签 git tag -a v2.0.0 -m "Release 2.0.0: 用户认证与支付模块" # 预发布版本标签 git tag -a v2.1.0-beta.1 -m "Beta 2.1.0: 新搜索功能预览" # 补丁版本标签 git tag -a v2.0.1 -m "Patch: 修复登录崩溃问题" # 查看所有标签 git tag -l git tag -l "v2.*" # 推送标签 git push origin v2.0.0 # 单个标签 git push origin --tags # 所有标签 # 删除标签 git tag -d v2.0.0 # 本地 git push origin --delete v2.0.0 # 远程
# 安装 conventional-changelog npm install -g conventional-changelog-cli # 生成 CHANGELOG conventional-changelog -p angular -i CHANGELOG.md -s # 首次生成完整历史 conventional-changelog -p angular -i CHANGELOG.md -s -r 0
保护主分支:禁止直接推送到 main/develop,强制通过合并请求
启用 rerere:团队级冲突记忆,避免重复解决相同冲突
git config --global rerere.enabled true
语义化版本:遵循 SemVer 规范管理版本号
发布分支隔离:发布期间仅允许修复,禁止新功能合并
定期清理分支:每周清理已合并的功能分支
git branch --merged main | grep -v "main|develop" | xargs git branch -d
强制审查:所有合并请求至少一人审查通过
提交信息校验:通过 Git Hook 校验提交信息格式
# .git/hooks/commit-msg
#!/bin/bash
if ! grep -qE "^(feat|fix|docs|style|refactor|perf|test|chore|revert)((.+))?: .{1,50}" "$1"; then
echo "提交信息不符合 Conventional Commits 规范"
exit 1
fi
# 启用后,首次解决冲突时 Git 会记录解决方案 git config --global rerere.enabled true # 再次遇到相同冲突时自动应用记忆的方案 git rerere diff # 查看当前记忆的解决方案 git rerere forget path/to/file # 忘记指定文件的方案 ls .git/rr-cache/ # 查看所有记忆的冲突
# 新功能应在 develop 分支继续开发 # release 分支仅接受缺陷修复 git checkout develop git flow feature start new-feature
# Git Flow 会自动合并 hotfix 到 main 和 develop git flow hotfix finish fix-urgent # 如有多环境分支,需手动同步 git checkout staging git merge main git push origin staging
# 方案一:使用 revert(保留历史,推荐) git revert v2.0.0..HEAD git commit -m "revert: 回滚 v2.0.0 之后的所有改动" # 方案二:使用 reset(重写历史,谨慎使用) git checkout main git reset --hard v1.9.0 git push --force-with-lease origin main
# 批量添加前缀 for branch in feature-a feature-b feature-c; do git branch -m "$branch" "legacy/$branch" done
# 1. 先同步目标分支 git fetch origin git checkout feature/complex git rebase origin/main # 2. 逐个文件解决冲突 git status # 编辑冲突文件... git add . git rebase --continue # 3. 如冲突过多,考虑重置后重新开发 git rebase --abort git checkout main git pull git checkout -b feature/complex-v2
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| Git | 命令行工具 | 必需 | 系统包管理器安装 |
| git-flow | 扩展工具 | 推荐 | brew install git-flow 或 apt install git-flow |
| conventional-changelog-cli | Node 工具 | 可选 | npm install -g conventional-changelog-cli |
| LLM API | API | 必需 | 由 Agent 内置 LLM 提供 |
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |