ABC Git Flow 工作流助手

帮助你在开发需求或修复 bug 时使用 abc-git-flow 工具管理 git 分支。

⚠️ Claude Code 用户注意：部分 git abc 命令需要交互式输入，在 Claude Code 中无法正常工作。推荐使用提供的 Python 脚本（见下方非交互式命令部分），避免终端阻塞。

安装

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、hotfix、hotfix-g 分支的正确命名格式。

需求开发 (Feature)

# 开始需求开发 - 从 develop 拉取分支
git abc feature start <feature-name>

# 完成需求开发 - 合并到 develop
git abc feature finish <feature-name>

正式环境紧急修复 (Hotfix)

# 开始修复 - 从 master 拉取分支
git abc hotfix start <hotfix-name>

# 完成修复 - 合并到 master/gray/rc/develop
git abc hotfix finish <hotfix-name>

灰度环境紧急修复 (Hotfix-g)

# 开始修复 - 从 gray 拉取分支
git abc hotfix-g start <hotfix-name>

# 完成修复 - 合并到 gray/rc/develop
git abc hotfix-g finish <hotfix-name>

RC 分支管理

# 将 develop 合入 rc（上线前）
git abc rc start

# 将 rc 合入 gray
git abc rc finish

灰度发布

# 将 gray 合入 master（灰度到全量）
git abc gray publish

Tag 管理

交互式命令（需要填写信息）：

# 创建 tag（会提示选择类型并填写信息）
git abc tag create

# 直接指定 tag 类型（但仍需填写上车/提测信息）
git abc tag create v
git abc tag create g
git abc tag create f

# 查看最近 tag
git abc tag show [类型]

# 配置 tag 前缀
git abc tag config [前缀]

非交互式脚本（推荐用于 Claude Code）：

# 创建正式环境 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 "无"

详细说明：参见 tag-create 详细指南，包含 tag 类型、分支约束、命令用法等完整说明。

Merge Request 管理

交互式命令（不推荐）：

git abc mr create  # 会进入交互式选择
git abc mr config  # 配置云效 Token

非交互式脚本（推荐用于 Claude Code）：

# 创建 MR（需要先配置 git abc mr config）
~/.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问题"

非交互式命令（Claude Code 推荐）

由于部分命令需要交互式输入，提供了 Python 脚本替代方案：

Tag 创建脚本 (scripts/tag_create.py)

完整参数：

• tag_type – Tag 类型 (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 Code 优化版）

需求开发流程

1. 从 develop 拉开发分支：

   git abc feature start <feature-name>
   

2. 进行需求开发、编码

3. 开发完成后，rebase develop 的代码，创建 f-tag：

   git rebase develop
   ~/.claude/skills/git-flow/scripts/tag_create.py f \
     --deps "无" \
     --operation "无" \
     --remark "feat: 实现新功能" \
     --tapd-id "1122044681001112866"
   

4. 提测完成，合并到 develop：

   git abc feature finish <feature-name>
   

5. 等待集成测试，创建 t-tag：

   ~/.claude/skills/git-flow/scripts/tag_create.py t \
     --deps "无" \
     --operation "无" \
     --remark "集成测试"
   

6. 集成测试完毕，将 develop 合入 rc，创建 p-tag：

   git abc rc start
   ~/.claude/skills/git-flow/scripts/tag_create.py p \
     --deps "abc-auth" \
     --operation "无"
   

正式环境 Bug 修复流程

1. 从 master 拉 hotfix 分支：

   git abc hotfix start <hotfix-name>
   

2. 修复后创建 t-tag 给测试同学：

   ~/.claude/skills/git-flow/scripts/tag_create.py t \
     --deps "无" \
     --operation "无" \
     --remark "hotfix: 修复xxx问题"
   

3. 测试完毕后合并到 master/gray/rc/develop：

   git abc hotfix finish <hotfix-name>
   

   注意：需要将 master、gray、rc 和 develop push 到远程

灰度环境 Bug 修复流程

1. 从 gray 拉 hotfix-g 分支：

   git abc hotfix-g start <hotfix-name>
   

2. 修复后创建 t-tag 给测试同学：

   ~/.claude/skills/git-flow/scripts/tag_create.py t \
     --deps "无" \
     --operation "无" \
     --remark "hotfix: 修复xxx问题"
   

3. 测试完毕后合并到 gray/rc/develop：

   git abc hotfix-g finish <hotfix-name>
   

   注意：需要将 gray、rc 和 develop push 到远程

分支说明

长期分支

临时分支

Tag 命名规范

格式：<前缀><年份>.<周数>.<构建号>

示例：pc-g2021.09.03 表示 pc 工程的 2021 年第 9 周第三次构建

Rebase 使用原则

推荐使用场景：

• 独立开发的分支，将源分支合并到该分支
• 本地分支同步远程分支修改

禁止使用场景：

• 多人协作的需求分支

示例：

# 自己的需求分支，同步 develop
git rebase develop

# 本地 develop 同步远程
git pull --rebase

其他命令

# 查看 abc-flow 版本
git abc -v

# 查看帮助
git abc -h

# 更新 git-abc
git abc update

命令支持情况对照

提示：在 Claude Code 中，优先使用非交互式脚本创建 Tag 和 MR，避免终端阻塞。