如何在GitHub中自动为分支名称添加递增式前缀？

我需要在创建GitHub分支时自动为分支名加上带递增数字的前缀，比如第一个分支前缀是IT-1-，第二个是IT-2-，以此类推。举个例子，如果我要创建名为checkout-improvements的分支，最终分支名要变成IT-1-checkout-improvements。之前在Bitbucket用过类似功能，不知道GitHub怎么实现。

可行的实现方案 #

GitHub本身没有内置这种自动添加递增前缀的功能，但可以通过以下几种方式实现：

1. 用GitHub Actions自动重命名分支

这是最适合团队协作的方案，能在分支创建后自动处理前缀：

• 在仓库的.github/workflows目录下创建branch-prefix.yml文件，写入以下内容：

name: Auto Add Branch Prefix
on:
  create:
    branches:
      - '**'
      - '!main' # 排除主分支，避免误操作
jobs:
  rename-branch:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout repository
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取所有分支信息，确保能获取历史分支的前缀数字
      - name: Calculate new prefix number
        id: get-number
        run: |
          # 提取所有带IT-*-前缀的分支数字，排序后取最大值
          NUMBERS=$(git branch -a | grep -o "IT-[0-9]*-" | grep -o "[0-9]*" | sort -n)
          MAX_NUM=$(echo "$NUMBERS" | tail -n 1)
          # 如果没有历史前缀分支，默认从1开始
          NEW_NUM=$([ -z "$MAX_NUM" ] && echo 1 || echo $((MAX_NUM + 1)))
          echo "new_num=$NEW_NUM" >> "$GITHUB_OUTPUT"
      - name: Rename and push branch
        run: |
          ORIGINAL_BRANCH="${GITHUB_REF#refs/heads/}"
          NEW_BRANCH="IT-${{ steps.get-number.outputs.new_num }}-$ORIGINAL_BRANCH"
          # 重命名本地分支并推送到远程
          git branch -m "$ORIGINAL_BRANCH" "$NEW_BRANCH"
          git push origin -u "$NEW_BRANCH"
          # 可选：删除原分支，避免仓库中存在无前缀的分支
          git push origin --delete "$ORIGINAL_BRANCH"

• 配置注意事项：
  • 在仓库的Settings → Actions → General中，确保Workflow拥有读写仓库内容的权限
  • 若多人同时创建分支，可能出现数字重复的情况，可以考虑在Action中添加锁机制，或者结合时间戳来生成唯一前缀（但会打破严格的递增序列）

2. 本地自定义Git命令别名

适合小团队或个人使用，创建分支时直接生成带前缀的分支名：

• 编辑本地的.gitconfig文件（全局路径为~/.gitconfig，仓库级为.git/config），添加以下别名：

[alias]
    create-prefixed = "!f() { \
        # 获取已存在的前缀数字最大值
        NUMBERS=$(git branch -a | grep -o \"IT-[0-9]*-\" | grep -o \"[0-9]*\" | sort -n); \
        MAX_NUM=$(echo \"$NUMBERS\" | tail -n 1); \
        NEW_NUM=$([ -z \"$MAX_NUM\" ] && echo 1 || echo $((MAX_NUM + 1))); \
        # 生成新分支名并创建推送
        NEW_BRANCH=\"IT-$NEW_NUM-$1\"; \
        git checkout -b \"$NEW_BRANCH\"; \
        git push origin \"$NEW_BRANCH\"; \
    }; f"

• 使用方式：运行git create-prefixed checkout-improvements，就能直接创建并推送IT-N-checkout-improvements分支（N为递增后的数字）

3. 分支保护+自定义工具

如果需要严格管控分支命名，可以结合分支保护规则和自定义工具：

• 先在仓库Settings → Branches → Branch protection rules中添加规则，拒绝推送无前缀的分支（可通过正则表达式匹配分支名）
• 开发自定义工具（比如基于GitHub API的脚本或GitHub App），让团队成员通过工具创建分支，工具内部自动计算递增前缀并调用API创建分支

内容的提问来源于stack exchange，提问作者Mohammad Afzali