企业级 Git 工作流方案,支持 Git Flow、团队协作、冲突工具集成与批量分支管理。
Git 工作流助手(专业版)
功能概述
Git 工作流助手(专业版)是一项面向实际任务的技能,主要用于本工具面向中大型研发团队,提供企业级 Git 工作流治理方案;在免费版基础能力之上,专业版引入 Git Flow / GitHub Flow / GitLab Flow 三大工作流模型的完整落地指引,支持多分支并行管理、批量分支操作、冲突自动记忆(rerere)、发布分支管理与版本标签策略;
核心要点
- 通过结构化流程与自动化脚本,帮助团队建立统一的版本控制规范。
- 它将相关步骤、工具调用和结果整理方式集中到统一流程中,帮助使用者更快完成目标并减少重复操作。
- 从功能定位来看,该技能强调把分散的操作要求整理成清晰、可复用的处理流程,使用户能够围绕既定目标快速准备输入、选择执行方式并获得结构化结果。
使用与执行
实际使用前应先确认任务范围、数据来源、运行环境、必要权限和关键参数,再依据技能说明逐步执行;若输入条件不完整,应先补齐信息或采用保守配置,避免因错误假设导致结果偏离需求。
结果检查与注意事项
执行过程中需要关注工具调用是否成功、接口或依赖是否可用、输出格式是否符合预期,并对异常提示、缺失字段和边界情况进行处理;涉及批量任务时,还应保存进度,避免中断后重复操作。
Git 工作流助手(专业版)
概述
本工具面向中大型研发团队,提供企业级 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中声明的使用场景,均已在上述能力点中提供对应的操作支持。
使用场景
场景一:Git Flow 发布流程管理
团队需要规划一个正式版本发布,包含功能开发、预发布验证、紧急修复全流程。
用户:我们需要发布 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 :{}
快速开始
- 阅读## 核心能力章节了解skill功能
- 按## 依赖说明配置环境
- 执行所需能力对应的命令
- 参考## 错误处理章节处理异常
- 查看## FAQ解答常见疑问
Git Flow 初始化配置
# 依赖说明 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 配置
# 启用冲突自动记忆 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 # 远程
CHANGELOG 自动生成配置
# 安装 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 规范管理版本号
- MAJOR:不兼容的 API 修改
- MINOR:向下兼容的功能新增
- PATCH:向下兼容的缺陷修复
发布分支隔离:发布期间仅允许修复,禁止新功能合并
定期清理分支:每周清理已合并的功能分支
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
常见问题
Q1:rerere 如何工作?
# 启用后,首次解决冲突时 Git 会记录解决方案 git config --global rerere.enabled true # 再次遇到相同冲突时自动应用记忆的方案 git rerere diff # 查看当前记忆的解决方案 git rerere forget path/to/file # 忘记指定文件的方案 ls .git/rr-cache/ # 查看所有记忆的冲突
Q2:如何处理 Git Flow 中 release 期间的新功能?
# 新功能应在 develop 分支继续开发 # release 分支仅接受缺陷修复 git checkout develop git flow feature start new-feature
Q3:hotfix 修复后如何同步到所有分支?
# Git Flow 会自动合并 hotfix 到 main 和 develop git flow hotfix finish fix-urgent # 如有多环境分支,需手动同步 git checkout staging git merge main git push origin staging
Q4:如何回滚已发布的版本?
# 方案一:使用 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
Q5:如何批量重命名多个分支?
# 批量添加前缀 for branch in feature-a feature-b feature-c; do git branch -m "$branch" "legacy/$branch" done
Q6:合并请求出现大量冲突怎么处理?
# 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
依赖说明
运行环境
- Agent 平台: 支持读取 SKILL.md 的任意 AI Agent(Claude Code / Cursor / Codex / Gemini CLI 等)
- 操作系统: Windows / macOS / Linux
- Git 版本: 建议 2.25 及以上(需支持 rerere、sparse-checkout)
- Node.js: 18.0+(CHANGELOG 生成工具依赖)
第三方依赖
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| 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 提供 |
API Key 配置
- 本工具为纯 Markdown 指令驱动,无需额外 API Key
- Git 远程推送需要配置 SSH Key 或个人访问令牌
- 团队协作建议配置统一的 GPG 签名密钥
可用性分类
- 分类: MD+EXEC(Markdown 指令 + 命令行执行)
- 说明: 通过自然语言指令驱动 Agent 执行 Git 操作,专业版功能依赖 git-flow 扩展和命令行执行能力
错误处理
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 执行ping命令测试网络连通性,检查防火墙和代理设置连接后执行ping命令测试网络连通性,检查防火墙和代理设置连接后重新执行命令,参考国内替代方案 |
已知限制
- 需LLM支持,无LLM环境不可用
- 复杂业务场景建议结合人工经验判断
- 执行效率受模型能力与网络环境影响
热门AI工具
相关专题
要对比两个版本的 git 文件,请使用 git diff 命令:git diff 比较工作树和暂存区之间的差异。git diff 比较两个提交或标签之间的差异。git diff 输出显示差异块,其中 + 表示添加的行,- 表示删除的行, 表示修改的行。可使用 gitkraken、meld、beyond compare 等可视化工具更直观地查看差异。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
2281
2024.04.09
git提交错误撤回的方法:git reset head^:撤回最后一次提交,恢复到提交前状态。git revert head:创建新提交,内容与之前提交相反。git reset :使用提交的 sha-1 哈希撤回指定提交。交互式舞台区:标记要撤回的特定更改,然后提交,排除已撤回更改。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。
2517
2024.04.09
Git是一个强大的版本控制系统,它提供了很多功能帮助开发人员有效地管理和控制代码的变更,本专题为大家提供git 撤销提交的commit相关的各种文章内容,供大家免费下载体验。
714
2023.07.24
git和svn的区别:1、定义不同;2、模型类型不同;3、存储单元不同;4、是否拥有全局版本号;5、内容完整性不同;6、版本库不同;7、克隆目录速度不同;8、分支不同。php中文网为大家带来了git和svn的相关知识、以及相关文章等内容。
1260
2023.07.06
本专题聚焦GoFrame框架的Web开发,拆解路由注册与匹配规则、请求参数获取、参数校验与中间件执行顺序,说明统一响应、JWT鉴权、文件上传与接口文档生成的落地方式,并补充优雅重启与测试实践。
0
2026.11.17
本专题围绕GoFrame框架的安装与工具链配置展开,讲清Go版本要求、gf命令行的安装方式、代理镜像与依赖准备,说明项目初始化、热编译、交叉编译打包的做法,并整理安装阶段的常见报错与验证步骤。
0
2026.11.17
本专题整理GoFrame框架的入门知识,从模块化设计理念、环境准备到跑通第一个Web服务,讲清目录分层、配置加载、日志与中间件的用法,并对比Gin、Go-Zero的差异,帮助Go开发者建立整体认知。
0
2026.11.17
SQLAlchemy 一对多关系怎么建立?本专题整理父子表外键、relationship 双向映射、关联查询、级联删除和加载优化等相关文章,帮助你理解并实现常见的 ORM 关系建模。
0
2026.11.17
热门下载
相关下载
精品课程
