这是其余文档引用的页面。它列出了每个执行阶段的名称,以便其他文章能准确说明某操作发生的位置。
流程路径
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_REVIEW | Coroid无法自行继续,正在向你询问相关问题 |
PAUSED | 暂时停止,可恢复 |
FAILED | 执行无法完成 |
CANCELLED | 由你手动停止 |
WONT_FIX | 刻意关闭,未执行相关工作 |
影响吞吐量的因素
一个智能体插槽一次只能运行一个任务。插槽决定了并行工作的数量,并不会加快单个任务的完成速度。任务本身的耗时取决于变更规模和测试套件的运行时间。
下一步
智能体角色——各智能体负责哪些阶段,以及各自被允许执行的操作。