一个任务是最终生成一个 pull request 的工作单元。从 开始创建一个:新任务.
挑选合适的首个任务
最佳的首个任务应当规模较小、具备实际价值,且与现有测试用例相关。例如
“为导出命令添加一个与导入命令输出格式相匹配的--json标识”,这样 Coroid 就能明确目标,你也能直观了解最终结果。
首次使用时请避免以下情况:
- 涉及身份验证、支付或数据迁移的内容
- 需要你尚未做出的设计决策的工作
- 模糊的清理工作——“优化错误处理”这类表述没有明确的完成标准
描述你的需求
撰写预期成果,而非实现方式。说明工作完成后应满足的条件,以及任何非显而易见的要求:重要的文件、需遵循的规范、无需改动的部分。
你无需自行编写计划。这正是 Coroid 首先生成的内容,而你可以对其进行批准。
如果存在代码无法涵盖的背景信息——比如架构决策记录、风格指南或工单——请将其附上。可查看项目背景了解 Coroid 无需额外告知便能掌握的内容。
审核规格说明
Coroid 会将你的描述转化为规格说明:明确要构建的内容、排除范围以及判定是否成功的验收标准。该内容会显示在任务的规格说明标签页中。
在正式开发前请先阅读它。如果验收标准与你的实际需求不符,现在就予以修正——它们正是后续验证阶段所依据的标准。可查看规格说明.
批准计划
对于非简单的变更而言,规格说明会进一步转化为计划:即有序的步骤集合。在编写代码前你需要对其予以批准。
这是干预成本最低的阶段。驳回计划仅需花费一分钟;而驳回已完成的 pull request 则会导致整个流程重新执行。
查看运行过程
一旦获批,任务便会进入PENDING,直至有可用的智能体插槽,随后便开始执行IN_PROGRESS。你可以实时跟踪运行进度:包括执行的步骤、调用的工具、修改的文件以及逐步生成的测试输出结果。
你无需全程观看。当任务需要你介入或完成后,系统会通过通知告知你。
预期情况
- 耗时由变更的规模及测试套件的运行时间决定,而非你拥有的智能体插槽数量。插槽仅用于控制同时运行的任务数量。
- **
NEEDS_HUMAN_REVIEW并非运行失败。**这意味着 Coroid 遇到了只有你才能做出的决策。回复后任务便会继续运行。 - **返工是正常现象。**如果审核人员发现问题,会在你看到结果前将其退回给开发人员。
下一步
审核并合并最终结果——查看生成的内容及需要核查的项目。