如何通过GitHub Actions实现仅docs文件夹改动时单审核人分支保护？

一、GitHub原生分支保护规则实现（最优解） #

GitHub自带的分支保护规则支持按路径匹配设置差异化审核要求，完全不需要依赖Actions，安全且可靠：

• 保留现有要求2名审核人的分支保护规则，覆盖所有路径；
• 新增一条优先级更高的分支保护规则：
  • 目标分支与原规则一致（例如main）；
  • 在「路径包含」项中填入docs/**；
  • 将「所需审核人数」设为1；
  • 确保这条规则在规则列表中位置更靠上（GitHub会优先匹配更具体的路径规则）。

当PR仅改动docs目录下的文件时，会触发这条1人审核的规则；若改动其他目录或混合改动，则会沿用原有的2人审核要求。

二、GitHub Actions变通方案（原生规则不可用时备用） #

如果你的GitHub环境不支持路径分支保护（比如旧版本），可以用Actions配合状态检查实现，全程不需要禁用分支保护：

1. 保留原有的2人审核分支保护规则；
2. 编写核心逻辑如下的工作流：
   • 拉取PR代码，检测改动文件范围，判断是否仅修改了docs/**路径；
   • 若仅改动docs文件，调用GitHub API创建一个自定义状态检查，标记为「通过」；
   • 在分支保护规则中添加这个自定义状态检查为「必需检查项」；
   • 同时将Actions运行所用的服务账号加入分支保护的「绕过审核要求」列表，但仅当该状态检查通过时，才允许绕过额外的审核人要求。

关键注意点 #

• 严格限制Actions的权限，仅授予读取PR内容和创建状态检查的权限，禁止修改分支保护规则；
• 务必测试混合改动场景（比如同时改docs和src文件），确保逻辑不会误触发绕过。

避坑提醒 #

绝对不要采用禁用分支保护的方案，无论是否临时，都会给仓库带来不可控的安全风险。

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