一个任务是最终生成一个 pull request 的工作单元。可从新任务中选取任务选项,在创建为下设置即可。将其保留为自动模式时,Coroid 会自行决定创建任务还是方案。
挑选合适的首个任务
最佳的首个任务应当规模较小、具备实际价值,且与现有测试用例关联紧密。例如
“为导出命令添加对应导入命令已支持的输出格式的--json标识”,就能为 Coroid 明确工作目标,也能让你清晰了解最终结果。
首次使用时需避免以下情况:
- 涉及身份验证、支付或数据迁移的相关工作
- 需要你尚未做出的设计决策的工作
- 模糊的清理类任务——“优化错误处理”这类表述没有明确的完成标准
描述你的需求
撰写内容应聚焦最终结果而非实现方式。写明工作完成后应满足的条件,以及所有非显而易见的要求:涉及的重要文件、需遵循的规范、无需修改的部分。
你无需自行编写方案。这恰恰是 Coroid 首先生成的内容,而你只需予以批准。
如果有些上下文信息代码无法体现——比如架构决策记录、风格指南、工单——可将其附上。详情请参阅项目上下文,了解 Coroid 无需额外告知便已掌握的信息。
财务团队经常要求以电子表格形式获取发票。请在发票列表中添加一个导出按钮,可将当前筛选结果下载为CSV格式。
完成标准为:文件可在Excel和Numbers中打开,金额显示使用账户货币单位,且导出超过10,000行数据时不会超时。
新建工作表单:选择要创建的内容,指定项目,随后在标题和简述中描述预期成果。
继续进入资格审核流程
选择继续目前尚未创建任何内容:Coroid 会先筛选请求,将其与当前发布版本比对,排查重复项并确认处理路径。审核通过后,任务即被创建并加入队列;若Qualification环节驳回请求,系统会说明具体原因,此时你可编辑请求后重新提交。详情请参阅描述你的需求。
审核规格说明
Coroid 会将你的描述转化为规格说明:明确要构建的内容、排除范围以及判定是否成功的验收标准。该内容会显示在任务的规格说明标签页中。
在着手开发前请先阅读该内容。若验收标准与你的实际需求不符,需立即修正——后续验证阶段将依据这些标准开展测试。详情请参阅规格说明。
批准计划
对于非简单变更而言,规格说明会进一步转化为计划:即一系列有序的步骤。编写代码前需先对其予以批准。
这是干预成本最低的阶段。驳回计划的耗时仅需一分钟,而驳回已完成的pull request则会导致整个运行流程作废。
查看运行过程
任务创建后,会先进入PENDING状态,直至有可用的代理插槽,随后才会开始执行IN_PROGRESS。你可实时跟踪运行进度:包括执行的步骤、调用的工具、涉及的文件以及逐步生成的测试输出结果。
无需全程监控。任务需要你介入或完成后,系统会通过通知及时告知你。
预期情况
- 耗时由变更规模和测试套件的运行时长决定,而非你拥有的代理插槽数量。插槽仅用于控制同时运行的任务数量。
NEEDS_HUMAN_REVIEW并非运行失败。这意味着Coroid遇到了只有你才能决定的问题。回复后任务便会继续运行。- 返工是正常现象。若审核人员发现问题,会在你看到前先将任务退回给开发人员修改。
下一步
审核并合并最终结果——说明最终交付的内容及需要核查的事项。