来自Coroid的pull request在呈现给您之前已经过校验。本节将介绍其含义及配置方法。
校验层级
校验并非单一环节,共包含四个层级,每个层级解决不同的问题。
您的测试套件这是最可靠的校验信号,因为它已经体现了团队认定的重要标准。Coroid会在每个任务中于干净的工作空间内运行该套件。
质量门禁由策略定义的校验项:代码覆盖率、代码规范检查、安全扫描及浏览器测试。阻断型门禁会阻止任务继续;提示型门禁会记录结果但允许任务继续。详见质量策略与门禁.
审核审核智能体将读取已完成的代码差异并生成校验结果。可修复的问题会退回给开发者重新处理;其余结果会附加到pull request上。
校验依据预览部署结果、扫描报告及代码覆盖率差异会直接附加在pull request上,因此校验信息会与代码一同呈现。详见审核依据.
校验所能证明及无法证明的内容
校验可确认该变更符合预期功能、不会破坏现有逻辑,且满足您设定的标准。
它能无法证明该变更是值得开发的。这一点需由需求说明中的验收标准以及人工审核来判定。
即便通过所有校验层级,变更仍可能是错误的。明确区分这一点才能确保整个流程的可信度——一旦将校验结果等同于最终判断,人们便不会再认真审核。
提前运行校验的意义
每个层级都会在pull request生成前运行,这样失败结果会作为返工任务在处理过程中返回,而非形成一份您只能拒绝的pull request。
在工作空间内发现问题是比在界面上发现更省钱的做法。您的审核应是首次人工查看,而非首次浏览。
入门指南
如果您是首次配置此项功能:
- 请确保您的测试套件能正常运行——详见 构建与测试配置如果这一步出错,其他设置都毫无意义。
- 在您的标准层级设置组织默认策略,无需采用最严格的标准。
- 连接您已在使用的校验依据提供方。
- 逐一添加门禁,优先添加提示型门禁。