如何自动将团队添加到同组织新创建的GitHub仓库中

你推测的没错，组织级GitHub Actions确实是更高效的方案——尤其是当你需要给组织下多个仓库统一添加团队权限时，仓库级工作流只能单仓库操作，重复配置成本太高。下面是具体实现步骤：

前提条件 #

1. test-team已属于test-org组织
2. 你拥有test-org的管理员权限（需要创建组织级Secrets、配置工作流）

步骤1：创建组织级工作流仓库 #

组织级工作流必须存储在组织名下的.github仓库中（如果没有这个仓库，先创建一个私有/公开仓库，命名为.github）。

步骤2：编写组织级工作流文件 #

在.github/workflows/目录下新建add-team-to-repos.yml，内容如下（支持手动触发、指定仓库过滤规则、选择权限）：

name: Add test-team to Organization Repos
on:
  workflow_dispatch:
    inputs:
      repo-filter:
        description: '可选：按仓库名称过滤（例如 "test-*"）'
        required: false
        default: '*'
      permission:
        description: '授予test-team的权限'
        required: true
        default: 'write'
        type: choice
        options:
          - read
          - write
          - maintain
          - admin

jobs:
  add-team:
    runs-on: ubuntu-latest
    steps:
      - name: 安装GitHub CLI
        run: |
          type -p curl >/dev/null || (sudo apt update && 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: gh auth login --with-token <<< "${{ secrets.ORG_PAT }}"
        env:
          ORG_PAT: ${{ secrets.ORG_PAT }}

      - name: 列出目标仓库
        id: list-repos
        run: |
          repos=$(gh repo list test-org --limit 1000 --name "${{ github.event.inputs.repo-filter }}" --json name --jq '.[].name')
          echo "repos=$repos" >> $GITHUB_OUTPUT

      - name: 给每个仓库添加test-team
        run: |
          for repo in ${{ steps.list-repos.outputs.repos }}; do
            echo "正在给test-org/$repo添加test-team，权限为${{ github.event.inputs.permission }}..."
            gh repo edit test-org/$repo --add-team test-team:${{ github.event.inputs.permission }}
          done

步骤3：配置组织级Secrets #

1. 进入test-org组织的设置页面，找到Secrets and variables -> Actions
2. 创建一个新的Secret，命名为ORG_PAT
3. 填入一个具备repo和admin:org权限的Personal Access Token（PAT），这个TOKEN必须由组织管理员账号生成

步骤4：触发工作流 #

进入test-org组织的Actions页面，找到刚才创建的Add test-team to Organization Repos工作流，点击Run workflow：

• 可选填写仓库过滤规则（比如只匹配名称以test-开头的仓库）
• 选择要授予的权限
• 点击Run workflow即可执行批量添加

单仓库场景的替代方案 #

如果只是给单个仓库添加团队，也可以用仓库级工作流，但只需执行一行命令即可：

name: Add test-team to This Repo
on: workflow_dispatch

jobs:
  add-team:
    runs-on: ubuntu-latest
    steps:
      - name: 安装并认证GitHub CLI
        run: |
          type -p curl >/dev/null || (sudo apt update && 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
          gh auth login --with-token <<< "${{ secrets.REPO_PAT }}"
        env:
          REPO_PAT: ${{ secrets.REPO_PAT }}

      - name: 添加test-team
        run: gh repo edit ${{ github.repository }} --add-team test-team:write

这种方式需要在目标仓库的Secrets中存储具备repo权限的PAT。

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