如何跳过GitHub Action？能否为复合动作添加根级if条件？

问题背景 #

想为整个GitHub复合动作（而非单个步骤）添加if条件，比如跳过由dependabot触发的动作执行。已知工作流级别可以添加if语句，但希望了解能否在复合动作本身的配置中实现。

结论 #

GitHub复合动作的元数据语法不支持在runs根级别直接添加if条件，你示例中注释的if: github.actor != 'dependabot[bot]'放在runs字段下是无效的——官方定义的复合动作runs字段仅支持using、steps、pre、post等有限配置项，没有if这个参数。

可行替代方案 #

方案1：工作流调用时添加条件（推荐）

这是最简洁的实现方式，直接在调用复合动作的位置添加if判断，无需修改动作本身：

jobs:
  your-job:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      # 调用复合动作时添加跳过条件
      - uses: your/hello-world-action@v1
        if: github.actor != 'dependabot[bot]'

方案2：复合动作内部统一控制

如果必须在动作内部实现判断，可以通过前置步骤标记执行状态，让所有业务步骤依赖该状态：

修改后的复合动作代码：

name: 'Hello World'
description: 'Greet someone'
inputs:
  who-to-greet:
    description: 'Who to greet'
    required: true
    default: 'World'
outputs:
  random-number:
    description: "Random number"
    value: ${{ steps.random-number-generator.outputs.random-number }}
runs:
  using: "composite"
  steps:
    # 前置步骤：判断是否允许执行后续业务逻辑
    - id: check_execution
      run: |
        if [ "${{ github.actor }}" = "dependabot[bot]" ]; then
          echo "allowed=false" >> $GITHUB_OUTPUT
        else
          echo "allowed=true" >> $GITHUB_OUTPUT
        fi
      shell: bash

    # 所有业务步骤添加条件，仅当允许时执行
    - run: echo Hello ${{ inputs.who-to-greet }}.
      shell: bash
      if: steps.check_execution.outputs.allowed == 'true'

    - id: random-number-generator
      run: echo "random-number=$(echo $RANDOM)" >> $GITHUB_OUTPUT
      shell: bash
      if: steps.check_execution.outputs.allowed == 'true'

    - run: echo "${{ github.action_path }}" >> $GITHUB_PATH
      shell: bash
      if: steps.check_execution.outputs.allowed == 'true'

    - run: goodbye.sh
      shell: bash
      if: steps.check_execution.outputs.allowed == 'true'

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