审核证据审核证据是附属于对应pull request的验证证明:可以是可打开的预览链接、扫描结果、覆盖率差异数据,或是录制的浏览器运行记录。
原理很简单——证据和它所描述的代码应当一同呈现。如果扫描结果存放在没人会查看的独立仪表盘中,那它不算证据,只是额外的工作而已。
可附加的内容
Coroid集成了多类提供商:
| 类别 | 提供商 |
|---|---|
| Git原生 | GitHub Actions环境、GitLab Review Apps |
| 静态托管 | Vercel、Netlify、Cloudflare Pages、AWS Amplify |
| 全栈预览 | Render、Railway、Heroku Review Apps、Fly.io、Northflank、Qovery、Porter |
| 移动端分发 | Expo EAS、TestFlight、Google Play内部测试 |
| 审核与扫描 | CodeRabbit、Qodo / PR-Agent、Greptile、Cursor Bugbot、SonarQube Cloud、Snyk、Semgrep |
| 覆盖率与视觉 | Codecov、Chromatic、Percy |
| 端到端测试与监控 | Cypress Cloud、Checkly、Maestro、BrowserStack |
| 自定义 | 自定义证据网页钩子 |
共有31个提供商。自定义证据网页钩子可覆盖列表中未列出的所有类型。
每个提供商都会声明其可生成的证据类型——网页预览、移动端构建、AI审核结果、安全扫描报告、覆盖率数据、视觉审核结果、端到端测试及性能数据——以及Coroid获取这些证据的方式:是通过Git接口、CI输出,还是直接调用提供商的API。
你很可能已经具备其中大部分能力
这正是核心价值所在。采用Coroid的团队通常已经拥有预览部署、扫描工具和覆盖率报告功能。审核证据功能只是将现有工具衔接起来,而非取代它们。
在组织连接设置中配置好提供商后,证据便会自动附加到Coroid创建的拉取请求中。
证据与关卡
证据和关卡二者相关但各有区别:
- 证据是供人参考的信息。
- 关卡是系统强制执行的决策。
证据可以为关卡提供依据——比如覆盖率阈值关卡会读取覆盖率证据——但多数证据仅作为参考信息。并非所有值得查看的内容都值得用来作为阻塞条件。
选择要附加的证据
证据越多并不代表越好。每项证据都会占用审核人的注意力,携带15个附件的pull request和携带3个附件的pull request得到的关注程度并无差别。
附上能影响决策的内容:
- 一个预览只要变更涉及用户可见内容时
- 覆盖率当覆盖率差异具有参考价值时
- 安全扫描涉及输入处理、身份验证或依赖项的内容
- 视觉差异设计系统和组件相关工作