如何实现组织内所有仓库提交时触发指定GitHub仓库的工作流？

company/repo_A -> some commit \
company/repo_B                 -> run workflow in company/repo_codecheck
company/repo_C -> some commit /
company/repo_D

我们希望为组织内所有仓库实现代码质量检查，即在每次提交时运行一条CLI命令。但组织内有成千上万个仓库，逐个添加仓库级工作流难度极大。

问题 #

1. GitHub是否支持在其他仓库有提交时，触发某一特定仓库中的工作流？
2. 是否存在比已调研方案1更优的实现方式？能否无需搭建新基础设施，当组织内任意仓库有提交时，直接运行company/repo_codecheck中的工作流？

已调研方案 #

• 方案1：创建GitHub应用，通过Webhook URL监听提交事件，由该应用运行CLI命令或调用GitHub API触发工作流
  • 挑战：需托管应用的基础设施及成本，且要暴露外部端点
• 方案2：使用GitHub API为每个仓库创建工作流文件
  • 挑战：团队可能反感修改其仓库，提交还可能触发现有工作流

可行方案（无需额外基础设施） #

可以通过组织级Webhook + 目标仓库的repository_dispatch工作流实现，完全依赖GitHub原生能力，无需自建服务：

1. 配置组织级Webhook #

• 在组织设置中创建Webhook，监听push事件（对应代码提交动作）
• 设置Payload URL为目标仓库的GitHub API调度端点：https://api.github.com/repos/company/repo_codecheck/dispatches
• 请求方法选择POST，认证使用具备repo权限的Personal Access Token（PAT），将其放入请求头Authorization: token <你的PAT>中
• 内容类型选application/json，Payload可自定义，传递触发提交的仓库名称、提交SHA等关键信息

2. 配置目标仓库的工作流 #

在company/repo_codecheck的.github/workflows/目录下创建工作流文件（例如code-check.yml），示例内容：

name: 组织代码质量检查
on:
  repository_dispatch:
    types: [push_event] # 需与Webhook发送的事件类型匹配

jobs:
  code-check:
    runs-on: ubuntu-latest
    steps:
      - name: 拉取触发仓库的代码
        uses: actions/checkout@v4
        with:
          repository: ${{ github.event.client_payload.repository.full_name }}
          ref: ${{ github.event.client_payload.sha }}
      
      - name: 运行代码质量检查CLI命令
        run: |
          # 替换为你的实际代码检查CLI命令
          your-code-quality-check-cli

该方案的核心优势：

• 无侵入：不需要修改组织内任何仓库的代码或配置
• 低成本：完全利用GitHub原生能力，无需额外基础设施投入
• 易维护：所有检查逻辑集中在repo_codecheck仓库，统一更新和管理

如果你的组织使用GitHub Enterprise Cloud，还可以借助组织级全局Webhook进一步简化配置流程。

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