Pull RequestにおけるCIは本当に必須か？

マージキューの最も基本的な機能は、エンキューされたPull Request（PR）を常に最新の master ブランチに取り込んだ状態でCIを実行することです。これによりmaster ブランチのCI成功が保証されるため、私たちはまず「master ブランチへのマージ後のCI」を不要と判断しました。

さらに、私たちはもう一歩踏み込んで考えました。

「そもそも、PR上でのCI実行も必須ではなくなったのでは？」

仮にPR単体でCIが失敗したとしても、その変更はマージキューのCIで検知され、キューから自動的に取り除かれます。master ブランチが壊れることはないため、PR作成時のCIはあくまで開発者のための任意実行とし、マージをブロックする「必須チェック」から外せるのではないか、という発想です。

CIを「必須」と「任意」に分ける方法

この「PRでのCIを必須としない」運用を実現するには、一つ技術的な壁がありました。

GitHubの仕様上の壁

GitHubの仕様では、PRの必須チェック（Required Check）とマージキューの必須チェックを分けることができません。マージキューでマージ前にチェックしたいCIはPRでも常に実行する必要があります。
こちらはマージキューへのフィードバックとして挙がっていますが、2025年7月時点では対応されていませんでした。

ref. https://github.com/orgs/community/discussions/46757#discussioncomment-4912738

PRでの必須チェックを外すためにチェックを外すと、マージキューでも必須ではなくなってしまい、CIが実行されないままマージされる問題が生じます。

ワークフロー分割による解決策

そこで我々は、CIのコアロジックを再利用可能なワークフロー（_ci.yml）として切り出し、それを呼び出す2つのワークフローに分割することで、この問題を解決しました。

1. ci.yml（マージキューでの必須CI）

これをブランチ保護ルールの必須チェックに設定します。このワークフローはpushイベントとmerge_groupイベントの両方でトリガーされますが、github.event_nameを判定し、merge_groupイベントでない場合はskip: trueを渡すことで、CIの実行をスキップします。

これにより、「必須チェックとしては存在するが、PR上では即座に完了（スキップ）し、マージキューでのみ実行される」状態を作り出せます。

# .github/workflows/ci.yml
name: ci

on:
  push:
    branches:
      - '**'
      - '!master'
  merge_group:

jobs:
  ci:
    # ...
    uses: ./.github/workflows/_ci.yml
    with:
      # merge_group イベントでない場合は true を渡し、ワークフローをスキップさせる
      skip: ${{ github.event_name != 'merge_group' }}
    secrets: inherit

2. ci_branch.yml（PRでの任意CI）

こちらは必須チェックには設定しません。pushイベントでのみトリガーされ、常にskip: falseを渡してCIを実行します。開発者はこのCIの結果を参考にしますが、完了を待たずにエンキューできます。

# .github/workflows/ci_branch.yml
name: ci branch

on:
  push:
    branches:
      - '**'
      - '!master'

jobs:
  ci:
    uses: ./.github/workflows/_ci.yml
    with:
      # こちらは常に false を渡し、CIを実行させる
      skip: false
    secrets: inherit

この構成により、「PR上ではCI実行は必須ではないが、マージキューではCI実行が必須」という状態を実現しました。