GitHub规则集Required Workflow存放位置及宿主仓库执行规避

核心方案 #

要同时满足「能被组织规则集识别为Required Workflow」和「不在宿主仓库执行」，需要结合目录放置要求和触发条件限制来实现：

1. 必须将工作流放在宿主仓库的.github/workflows目录下
   目前GitHub规则集仅识别该目录下的工作流作为Required Workflow，官方文档提到的「任意文件夹」暂未在实际场景中生效，因此必须保留在此目录才能被规则集引用。

2. 通过触发条件或Job判断，阻止宿主仓库执行该工作流
   有两种可靠的实现方式：

   方式一：在触发层面排除宿主仓库

   在工作流的on字段中添加仓库匹配规则，仅允许目标仓库的事件触发工作流，直接排除宿主仓库：

   on:
     pull_request:
       types: [opened, synchronize, reopened]
     repository:
       # 匹配所有需要应用规则集的目标仓库（支持通配符）
       - 'your-org/target-repo-*'
       # 明确排除宿主仓库
       - '!your-org/host-repo'
   

   方式二：在Job级别添加执行判断

   如果需要更灵活的控制，可在Job中添加if条件，判断当前执行仓库不是宿主仓库：

   jobs:
     required-validation:
       runs-on: ubuntu-latest
       # 仅当当前仓库不是宿主仓库时才执行
       if: github.repository != 'your-org/host-repo'
       steps:
         - name: Execute required checks
           run: |
             echo "Running required workflow checks for target repo"
             # 这里添加你的验证逻辑
   

补充说明 #

• 方式一从触发阶段就拦截了宿主仓库的事件，性能更优；方式二则是在任务执行前判断，适合需要保留触发记录但不执行任务的场景。
• 请将上述代码中的your-org/host-repo和your-org/target-repo-*替换为实际的组织、宿主仓库和目标仓库名称。

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