文档

Coroid 如何验证自身产出成果

为何来自Coroid的pull request已经过校验,各校验层级究竟能证明什么。

来自Coroid的pull request在呈现给您之前已经过校验。本节将介绍其含义及配置方法。

校验层级

校验并非单一环节,共包含四个层级,每个层级解决不同的问题。

您的测试套件这是最可靠的校验信号,因为它已经体现了团队认定的重要标准。Coroid会在每个任务中于干净的工作空间内运行该套件。

质量门禁由策略定义的校验项:代码覆盖率、代码规范检查、安全扫描及浏览器测试。阻断型门禁会阻止任务继续;提示型门禁会记录结果但允许任务继续。详见质量策略与门禁.

审核审核智能体将读取已完成的代码差异并生成校验结果。可修复的问题会退回给开发者重新处理;其余结果会附加到pull request上。

校验依据预览部署结果、扫描报告及代码覆盖率差异会直接附加在pull request上,因此校验信息会与代码一同呈现。详见审核依据.

校验所能证明及无法证明的内容

校验可确认该变更符合预期功能、不会破坏现有逻辑,且满足您设定的标准。

它能无法证明该变更是值得开发的。这一点需由需求说明中的验收标准以及人工审核来判定。

即便通过所有校验层级,变更仍可能是错误的。明确区分这一点才能确保整个流程的可信度——一旦将校验结果等同于最终判断,人们便不会再认真审核。

提前运行校验的意义

每个层级都会在pull request生成前运行,这样失败结果会作为返工任务在处理过程中返回,而非形成一份您只能拒绝的pull request。

在工作空间内发现问题是比在界面上发现更省钱的做法。您的审核应是首次人工查看,而非首次浏览。

入门指南

如果您是首次配置此项功能:

  1. 请确保您的测试套件能正常运行——详见 构建与测试配置如果这一步出错,其他设置都毫无意义。
  2. 在您的标准层级设置组织默认策略,无需采用最严格的标准。
  3. 连接您已在使用的校验依据提供方。
  4. 逐一添加门禁,优先添加提示型门禁。

本节内容