2026年6月2日

规划器 Agent——从需求到可执行的计划

Datarim 的规划器 Agent 如何将模糊的需求转化为结构化的实施计划,包含组件拆解、回滚策略和具体的验证清单。

一个任务描述写着“添加导出为 CSV 功能”。这句话里没有设计,没有回滚路径,也没有办法判断工作何时完成。规划器 Agent 会接收这句话,并产出开发者——无论是人类还是 AI——真正可以执行的内容。

规划器是流水线中的首席项目经理。它在 /dr-init 阶段运行,用于在待办列表中创建任务;随后在 /dr-plan 阶段再次运行,用于编写实施计划。它使用阵容中最强的模型,因为计划中的模糊性会在后续每一步中不断累积放大。

它的职责

每个任务都会获得一个复杂度等级——从 L1 到 L4——该等级决定了在开始实施之前需要进行多少设计工作。一个小型缺陷修复属于 L1,直接进入编码。一个带有公开 API 的新服务属于 L4,会先经历完整的设计阶段。

对于 L3 和 L4 任务,规划器会产出一份详细设计,包含三个组成部分:组件拆解(要构建什么以及各部分如何连接)、接口定义(从外部看代码边界是什么样子),以及用文字描述的数据流图。该设计会进一步形成一份计划,其中包含明确的实施步骤、代码示例、使用 git 或迁移命令的回滚策略,以及由具体检查项组成的验证清单——不是“测试一下”,而是“运行此命令并验证此输出”。

一个具体示例

一个任务到来:为现有 API 添加 webhook 投递系统。规划器将其评定为 L3。它阅读当前代码库,识别出已存在一个队列 worker,并编写组件拆解,展示三个部分——现有请求处理器中的队列生产者、用于投递的新 worker 进程,以及数据库中的重试表。实施计划列出了添加该表的迁移命令、生产者的确切函数签名,以及用于确认投递端到端正常运行的命令。如果部署过程中出现问题,回滚策略就是一条删除该表的迁移命令。

它在流程中的位置

规划器在流水线中最先运行——在任何代码编写之前。在 /dr-init 阶段,它注册任务并设定其复杂度等级。在 /dr-plan 阶段,它产出计划文档,供后续每个 Agent 阅读。对于复杂任务,规划器的设计会输入给策略师,由其在实施开始前评估所选方案是否正确。

请参阅规划器 Agent 卡片上的完整参考,或阅读Datarim 是什么以了解完整流水线的背景。