SuperAPI AI 工具集

git-flow

编程与开发

查看项目

更新于 10-15 08:12

技能介绍

ABC Git Flow 工作流助手用于在开发需求或修复 bug 时,通过 abc-git-flow 工具管理 git 分支。当用户请求“拉分支”“创建分支”“git flow”“分支管理”或类似操作时触发。

【安装】 安装技能: npx add-skill https://github.com/ABCFed/claude-marketplace/tree/main/skills/git-flow

安装 abc-git-flow: macOS:sudo curl https://cis-static-common.oss-cn-shanghai.aliyuncs.com/assets/abc-git-flow/git-abc-flow-install.sh 若报错 Bad CPU type,需执行:/usr/sbin/softwareupdate --install-rosetta --agree-to-license Windows:curl -# -O https://static-common-cdn.abcyun.cn/assets/abc-git-flow/install.bat && call install.bat Linux:curl https://static-common-cdn.abcyun.cn/assets/abc-git-flow/install-linux.sh | sh

安装 Python 依赖:pip install requests

【初始化】 首次使用需在工程目录下执行: git abc init git abc tag config <前缀>(配置 tag 前缀,如 pc、charge)

【常用命令】 需求开发(Feature): git abc feature start <feature-name>(从 develop 拉取分支) git abc feature finish <feature-name>(合并到 develop)

正式环境紧急修复(Hotfix): git abc hotfix start <hotfix-name>(从 master 拉取分支) git abc hotfix finish <hotfix-name>(合并到 master/gray/rc/develop)

灰度环境紧急修复(Hotfix-g): git abc hotfix-g start <hotfix-name>(从 gray 拉取分支) git abc hotfix-g finish <hotfix-name>(合并到 gray/rc/develop)

RC 分支管理: git abc rc start(将 develop 合入 rc,上线前) git abc rc finish(将 rc 合入 gray)

灰度发布: git abc gray publish(将 gray 合入 master,灰度到全量)

Tag 管理交互式命令: git abc tag create(提示选择类型并填写信息) git abc tag create v / g / f(指定 tag 类型,仍需填写上车/提测信息) git abc tag show [类型](查看最近 tag) git abc tag config [前缀](配置 tag 前缀)

【非交互式脚本(推荐用于 Claude Code)】 Tag 创建脚本 scripts/tag_create.py: 创建正式环境 tag:~/.claude/skills/git-flow/scripts/tag_create.py v --deps "abc-auth" --operation "无" 创建需求提测 tag:~/.claude/skills/git-flow/scripts/tag_create.py f --deps "无" --operation "无" --remark "feat: 实现新功能" --tapd-id "1122044681001112866" 创建灰度环境 tag:~/.claude/skills/git-flow/scripts/tag_create.py g --deps "abc-auth" --operation "无" 其他类型:p 创建预发布 tag;t 创建测试环境 tag。 完整参数:tag_type(f/t/v/g/p,必填)、--deps(依赖的服务)、--operation(需要的操作)、--remark(备注/说明)、--tapd-id(关联的 TAPD ID,f tag 可选)、-b/--business(业务线,默认 abc-his)、--prefix(Tag 前缀,从 git config 读取)、--hotfix(Hotfix 模式)、--skipdeploy(跳过上车/提测,仅创建 tag)。

MR 创建脚本 scripts/mr_create.py: ~/.claude/skills/git-flow/scripts/mr_create.py -t develop -T "feat: 新功能开发" -r 张三 李四 指定描述:~/.claude/skills/git-flow/scripts/mr_create.py -t develop -T "fix: 修复bug" -r 张三 -d "修复了xxx问题" 参数:-t/--target 目标分支(必填)、-T/--title MR 标题(必填)、-r/--reviewers 评审者姓名(必填)、-d/--description MR 描述、--skip-notify 跳过企业微信通知。创建 MR 前需先配置 git abc mr config。

【典型工作流程】 需求开发:从 develop 拉开发分支(git abc feature start)→ 开发编码 → rebase develop 并创建 f-tag → 提测完成合并到 develop(git abc feature finish)→ 等待集成测试创建 t-tag → 集成测试完毕将 develop 合入 rc(git abc rc start)并创建 p-tag。

正式环境 Bug 修复:从 master 拉 hotfix 分支(git abc hotfix start)→ 修复后创建 t-tag → 测试完毕合并到 master/gray/rc/develop(git abc hotfix finish),需将 master、gray、rc 和 develop push 到远程。

灰度环境 Bug 修复:从 gray 拉 hotfix-g 分支(git abc hotfix-g start)→ 修复后创建 t-tag → 测试完毕合并到 gray/rc/develop(git abc hotfix-g finish),需将 gray、rc 和 develop push 到远程。

【分支说明】 长期分支:master(正式环境稳定代码,不能直接开发)、gray(灰度环境稳定代码,不能直接开发)、rc(预发布环境分支,完成后合入 gray)、develop(新需求开发基础分支,汇集已完成功能)、experience(体验分支,不保证稳定性,用于体验最新特性)。 临时分支:feature(来源 develop,新功能开发分支)、hotfix(来源 master,正式环境紧急问题修复)、hotfix-g(来源 gray,灰度环境紧急问题修复)。

【Tag 命名规范】 格式:<前缀><年份>.<周数>.<构建号>。前缀:pc-f(feature 功能提测)、pc-t(release 集成测试)、pc-g(gray 灰度发布)、pc-v(master 全量发布)。示例:pc-g2021.09.03 表示 pc 工程的 2021 年第 9 周第三次构建。

【Rebase 使用原则】 推荐:独立开发的分支将源分支合并到该分支;本地分支同步远程分支修改。 禁止:多人协作的需求分支。 示例:git rebase develop(自己的需求分支同步 develop);git pull --rebase(本地 develop 同步远程)。

【其他命令】 git abc -v(查看 abc-flow 版本)、git abc -h(查看帮助)、git abc update(更新 git-abc)。

【命令支持情况】 Feature、Hotfix、RC 操作、Tag 配置为交互式命令;Tag 创建与 MR 创建推荐使用非交互式脚本,避免终端阻塞。在 Claude Code 中优先使用非交互式脚本创建 Tag 和 MR。