文档

任务如何转化为pull request

从工作描述到经过审核的 pull request 的完整流程,以及沿途的各个阶段名称。

这是其余文档引用的页面。它列出了每个执行阶段的名称,以便其他文章能准确说明某操作发生的位置。

流程路径

your description


   specification   what will be built, and how you will know it worked


   plan            the ordered steps, reviewed before any code is written


   build           code and tests written in an isolated workspace


   verify          your test suite, plus checks and quality gates


   review          an automated review pass over the diff


   pull request    on a branch, in your repository, waiting for you

规格说明

Coroid 并非直接基于你的描述启动,它首先会将你的描述转化为规格说明:明确要构建的内容、明确排除的范围,以及判定工作是否合格的验收标准。

这一点至关重要,因为验收标准是后续验证阶段所依据的依据。模糊的规格说明会导致难以评判工作成果。

你可以在任务的“规格说明”标签页上查看和编辑规格说明,规格说明以便在执行开始前完成相关设置。

《规格说明驱动开发指南》规格说明驱动开发指南详细说明了如何编写可测试的验收标准、设定范围边界,并在规划、实现和审核环节保持对成功定义的统一认知。

规划

对于超出小型变更范畴的任务,规格说明会进一步转化为规划:即按阶段分组的有序步骤集。在编写代码前,你需要先批准该规划。

拒绝规划的成本很低,当方案有误时这样做是正确的选择;而在代码编写完成后才拒绝则成本极高。这一阶段正是你的判断最能发挥作用的地方。

构建

智能体将代码库克隆到独立的工作空间中进行操作。它会读取代码、编写变更内容,并生成或更新测试用例。

该工作空间是临时的且按任务划分。智能体的操作不会影响到你的默认分支,同时同时运行的多个任务也无法看到彼此的进度。

验证

首先运行你自己的测试套件——这是最可靠的信号,因为它体现了团队已确定的重要标准。

在此基础上,质量门控会执行组织内配置的各项规则:覆盖率阈值、代码规范检查、安全扫描,以及针对预览部署的浏览器测试。阻塞型门控会终止任务;提示型门控会记录发现结果但允许任务继续。

审核

审核智能体会像同事一样阅读差异内容并生成发现结果。可修复的发现结果会被退回重新处理;其余结果则会附在pull request上供你查看。

正因如此,已审核的Coroid pull request才会被交付给你——并非取代你的审核工作,而是让你的审核不再是首次审核。

拉取请求

分支会被推送,同时针对你的基准分支创建pull request,其中包含变更内容、测试用例、验证结果以及审核发现结果。

Coroid的流程到此结束。合并操作由你决定。

任务状态

任务状态能反映其在上述流程中所处的位置:

状态含义
PENDING已接受,正在等待可用的智能体插槽
IN_PROGRESS正在积极处理中
PENDING_REVIEW工作已完成且经过审核,等待集成或批准
COMPLETED已交付
NEEDS_HUMAN_REVIEWCoroid无法自行继续,正在向你询问相关问题
PAUSED暂时停止,可恢复
FAILED执行无法完成
CANCELLED由你手动停止
WONT_FIX刻意关闭,未执行相关工作

影响吞吐量的因素

一个智能体插槽一次只能运行一个任务。插槽决定了并行工作的数量,并不会加快单个任务的完成速度。任务本身的耗时取决于变更规模和测试套件的运行时间。

下一步

智能体角色——各智能体负责哪些阶段,以及各自被允许执行的操作。