/dr-plan 命令 — 从需求到实施步骤
/dr-plan 如何将已批准的 PRD 转化为有序、依赖明确的实施计划,使开发者代理无需猜测即可遵循。
PRD 描述要构建什么。实施计划描述如何构建它。这两个产物之间的差距正是良好意图与现实碰撞的地方——遗漏的依赖、错误的顺序、未声明的安全风险。/dr-plan 命令通过将已批准的需求转化为具体、有序的实施步骤序列来弥合这一差距。
该命令读取由 /dr-prd 生成的 PRD 以及 tasks.md 中的任务条目,然后按照增强设计流程(第 4 至第 6 阶段)分三个阶段构建计划。输出是一份写入任务描述文件的结构化计划,按阶段和步骤组织,并明确它们之间的依赖关系。
它做什么
第 4 阶段采用 PRD 评审期间选定的技术方案,并将其分解为组件。每个组件都有一个范围定义、一个接口契约,以及一份它必须满足的验收标准列表。组件之间的依赖关系被明确表达——哪些组件必须先于其他组件存在才能构建。
第 5 阶段生成实施计划文档。该文档在 tasks.md 中结构化为一个精简的索引条目,指向一个专门的计划文件,并包含实施步骤、安全摘要、测试计划、回滚策略以及作为其章节之一的验证清单。该清单将每个步骤与一个特定命令、测试名称或可观察行为关联起来,以确认该步骤已完成,这些标准会在实施后输入到 /dr-qa 第 3 层。
第 6 阶段验证技术栈。它验证所有指定的依赖项、构建工具和环境变量确实存在于工作区中,并且每个验收标准验证命令都可针对当前代码库运行。这可以防止计划引用尚不存在的工具或标志。
一个具体示例
一个为通知服务添加 webhook 投递的任务会生成一个包含三个阶段的计划:第一,webhook 注册端点(无依赖);第二,从队列读取的投递工作进程(依赖第 1 阶段的数据模型);第三,带指数退避的重试逻辑(依赖第 2 阶段的工作进程)。每个阶段都有安全说明——第 1 阶段检查 URL 参数的输入验证;第 2 阶段检查工作进程不会以明文记录 webhook 负载。验证清单将每个阶段与一个特定的集成测试名称关联起来。开发者代理遵循此计划,无需猜测顺序。
它在流水线中的位置
plan 命令在 Level 2 及以上任务的 /dr-prd 之后运行。对于需要设计探索的 Level 3 和 4 任务,plan 会发出信号,表明应在实施开始前运行 /dr-design。对于不需要设计文档的较简单任务,plan 直接路由到 /dr-do。
plan 还会在保存前验证验收标准中引用的所有路径和脚本确实存在。尚不存在的路径必须标记为待创建,以便门禁能够区分有意交付物和虚假引用。这可以防止计划悄然与代码库脱节。
在 什么是 Datarim 中了解更广泛的流水线,或继续阅读 /dr-design 命令,了解复杂架构决策如何在编码开始前被探索。