GitHub规则集：配置特定合并检查且不阻塞无关PR

一、确保无关PR不被阻塞的方法 #

核心是让无目标路径变更的PR直接标记工作流为成功，而非pending或失败，可通过两种方式实现：

1. 工作流内添加前置判断逻辑 #

在job执行前先检测PR是否有目标路径变更，无变更时直接让工作流成功结束：

name: 路径相关审批与同步
on:
  pull_request:
    types: [opened, synchronize, reopened]

jobs:
  check-changes:
    runs-on: ubuntu-latest
    outputs:
      has_target_changes: ${{ steps.detect.outputs.has_changes }}
    steps:
      - name: 检出代码
        uses: actions/checkout@v4
        with:
          fetch-depth: 0 # 拉取完整历史用于检测变更
      
      - name: 检测目标路径变更
        id: detect
        run: |
          # 定义需要监控的文件路径
          TARGET_PATHS="src/backend/"
          # 对比PR分支与base分支的变更文件
          CHANGED_FILES=$(git diff --name-only ${{ github.event.pull_request.base.sha }} ${{ github.event.pull_request.head.sha }})
          # 判断是否有目标路径变更
          if echo "$CHANGED_FILES" | grep -qE "^$TARGET_PATHS"; then
            echo "has_changes=true" >> $GITHUB_OUTPUT
          else
            echo "has_changes=false" >> $GITHUB_OUTPUT
          fi

  approval-check:
    needs: check-changes
    if: needs.check-changes.outputs.has_target_changes == 'true'
    runs-on: ubuntu-latest
    steps:
      - name: 检查特定群组审批
        run: |
          # 此处编写检查特定GitHub群组审批的逻辑
          # 可通过GitHub API获取PR审批者，判断是否属于目标群组
          echo "特定群组审批检查通过"

  sync-repo:
    needs: [check-changes, approval-check]
    if: needs.check-changes.outputs.has_target_changes == 'true'
    runs-on: ubuntu-latest
    steps:
      - name: 同步变更到目标仓库
        run: |
          # 此处编写同步目标路径变更到另一个仓库的逻辑
          echo "变更同步完成"

  # 关键：无变更时直接标记工作流成功
  mark-success-if-no-changes:
    needs: check-changes
    if: needs.check-changes.outputs.has_target_changes == 'false'
    runs-on: ubuntu-latest
    steps:
      - name: 标记工作流成功
        run: echo "无目标路径变更，状态检查直接通过"

无目标路径变更时，mark-success-if-no-changes job执行，整个工作流显示为成功，不会阻塞PR合并。

2. 给RuleSets添加路径条件 #

在GitHub RuleSets中配置状态检查规则时，限定仅对有目标路径变更的PR生效：

• 进入仓库「Settings」→「Code and automation」→「Rulesets」
• 编辑或创建规则集，在「Conditions」中添加「Paths」条件，选择「Include」并填入目标路径（如src/backend/**）
• 仅变更目标路径的PR会触发该状态检查要求，无关PR不受影响

二、是否推荐用changed-files替代工作流级paths过滤？ #

推荐使用changed-files这类Action替代工作流级paths过滤，原因如下：

1. 解决pending阻塞问题：工作流级paths过滤会直接跳过整个工作流，导致状态显示为pending，无法满足RuleSets的合并检查要求；而changed-files可在工作流内判断变更，主动标记无变更的PR为成功状态。
2. 逻辑更灵活：支持更复杂的路径匹配规则（如排除子路径），还能根据变更结果精准控制后续job的执行，比工作流级paths的匹配能力更强。
3. 避免工作流跳过导致的状态异常：跳过的工作流无法自动标记为成功，而changed-files可以让无变更场景下的工作流正常完成并返回成功状态。

示例使用changed-files的简化逻辑：

steps:
  - name: 检测变更文件
    id: changed-files
    uses: tj-actions/changed-files@v41
    with:
      files: |
        src/backend/**

  - name: 执行审批检查（仅当有变更时）
    if: steps.changed-files.outputs.any_changed == 'true'
    run: echo "执行特定群组审批检查"

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