如何配置GitHub保护分支，要求已执行的所有检查必须通过？

可以实现这个需求，核心思路是通过汇总状态检查统一管控所有实际运行的CI任务结果，既避免直接将按需运行的检查设为必填导致的合并阻塞问题，又能满足Auto-Merge的触发条件。以下是两种可行方案：

方案一：在CircleCI工作流内实现汇总检查 #

• 改造.circleci/config.yml，新增一个最终的汇总步骤：
  • 配置CircleCI工作流，让所有按需运行的子检查（比如针对不同模块的CI任务）完成后，触发一个汇总任务。
  • 这个汇总任务仅在所有已运行的子检查都成功时，向GitHub发送标记为成功的状态检查（比如命名为circleci/aggregate-all-passed）；若有任何已运行的子检查失败，汇总任务则发送失败状态。
• 在GitHub保护分支main的「Require status checks to pass before merging」设置中，只将circleci/aggregate-all-passed添加到必填检查列表，无需添加那些按需运行的子检查。

方案二：用GitHub Actions辅助汇总状态 #

• 编写一个GitHub Actions工作流，监听PR的状态检查事件：
  • 工作流会收集当前PR中所有已完成的CircleCI检查状态。
  • 遍历这些状态，若所有已运行的检查都成功，则设置自定义的汇总状态（比如github/ci-aggregate-status）为成功；只要有一个已运行的检查失败，汇总状态就设为失败。
• 将这个自定义汇总状态添加到保护分支的必填检查列表中。

Auto-Merge配置注意事项 #

• 确保GitHub的Auto-Merge仅在汇总检查成功时触发——因为汇总检查成功意味着所有实际运行的CI任务都已通过，这样就能避免PR在未完成所有运行中的CI流水线时被提前合并。
• 不要将那些按需运行的单独CI检查设为必填，否则未触发该检查的PR会永远无法满足合并条件。

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