如何为通过模板创建的GitHub仓库自动添加标签？

问题背景 #

我们团队在GitHub上管理代码，要求新建仓库必须遵循特定规范——比如包含.github/workflows下的默认工作流、基础.gitignore、.github目录下的代码检查器配置文件等。为此我们用Cookiecutter搭建了仓库模板，它能自动生成符合规范的仓库内容，但不会执行git init，也不会在GitHub上创建仓库实体。

当前使用模板的流程是：

cookiecutter --output-dir new-repo-name https://github.com/our-org/our-template-repo
cd new-repo-name
git init
gh repo create new-repo-name --private --source=. --remote=upstream
git add .
git push

我们希望通过给这类模板创建的仓库添加特定标签来实现统一追踪，但原本想通过在.github目录放特定文件的方式行不通，请问有什么自动添加标签的方法？

可行的自动添加标签方案 #

1. 直接在gh repo create命令中追加标签参数 #

修改现有创建仓库的命令，用--add-topic参数直接指定要添加的标签，一步到位：

gh repo create new-repo-name --private --source=. --remote=upstream --add-topic "template-created,our-org-standard"

这个方法完全嵌入现有流程，不需要额外操作，创建仓库的同时就能自动打上指定标签。

2. 用Cookiecutter的post-gen钩子自动执行标签添加 #

在你的Cookiecutter模板仓库中创建hooks/post_gen_project.py脚本（记得给脚本加可执行权限），脚本里调用GitHub CLI完成标签添加：

import subprocess
import os

# 获取当前仓库路径和名称
repo_path = os.getcwd()
repo_name = os.path.basename(repo_path)
org_name = "our-org"  # 替换成你的组织名

# 调用gh命令给新仓库打标签
subprocess.run([
    "gh", "repo", "edit", f"{org_name}/{repo_name}",
    "--add-topic", "template-created,our-org-standard"
], check=True)

当你用模板生成仓库、完成gh repo create和代码推送后，这个钩子会自动触发，给新仓库打上标签。注意要确保用户的GitHub CLI已经完成登录授权。

3. 编写Shell脚本封装全流程 #

把现有步骤打包成一个Shell脚本，让团队成员一键完成所有操作，避免手动输入出错：

#!/bin/bash

# 接收仓库名作为参数
REPO_NAME=$1

# 用Cookiecutter生成仓库内容
cookiecutter --output-dir $REPO_NAME https://github.com/our-org/our-template-repo

# 初始化Git并创建GitHub仓库（同时打标签）
cd $REPO_NAME
git init
gh repo create $REPO_NAME --private --source=. --remote=upstream --add-topic "template-created,our-org-standard"

# 提交并推送初始代码
git add .
git commit -m "Initial commit from template"
git push

使用时只需要运行./create-repo.sh new-repo-name，就能自动完成仓库生成、创建、打标签和推送的全流程。

4. 用GitHub Actions批量补全标签（适合已创建的仓库） #

如果已经有一批用模板创建但没打标签的仓库，可以写一个GitHub Action定期扫描组织内的仓库，检查是否包含模板特有的文件（比如.github/workflows/default.yml），如果存在就自动添加标签。示例Workflow配置（放在组织的某个管理仓库中）：

name: 为模板创建的仓库添加标签
on:
  schedule:
    - cron: "0 0 * * *" # 每天凌晨执行一次
  workflow_dispatch: # 支持手动触发

jobs:
  add-tags:
    runs-on: ubuntu-latest
    steps:
      - name: 安装GitHub CLI
        run: |
          type -p curl >/dev/null || sudo apt install curl -y
          curl -fsSL https://cli.github.com/packages/githubcli-archive-keyring.gpg | sudo dd of=/usr/share/keyrings/githubcli-archive-keyring.gpg \
          && sudo chmod go+r /usr/share/keyrings/githubcli-archive-keyring.gpg \
          && echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/githubcli-archive-keyring.gpg] https://cli.github.com/packages stable main" | sudo tee /etc/apt/sources.list.d/github-cli.list > /dev/null \
          && sudo apt update \
          && sudo apt install gh -y

      - name: 授权GitHub CLI
        run: echo "${{ secrets.GITHUB_TOKEN }}" | gh auth login --with-token

      - name: 扫描仓库并添加标签
        run: |
          # 获取组织内所有私有仓库
          REPOS=$(gh repo list our-org --private --json name --jq '.[].name')
          for REPO in $REPOS; do
            # 检查是否存在模板特有的工作流文件
            if gh repo view our-org/$REPO --json files --jq '.files[] | select(.path == ".github/workflows/default.yml")' > /dev/null 2>&1; then
              # 添加标签
              gh repo edit our-org/$REPO --add-topic "template-created,our-org-standard"
              echo "已为仓库 $REPO 添加标签"
            fi
          done

需要给这个Action配置拥有仓库编辑权限的GITHUB_TOKEN。

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