/dr-prd 命令 — 代码之前的需求
了解 /dr-prd 如何运行结构化发现访谈、探索三种或更多技术方案,并生成一份 PRD,供流水线其余环节视为事实来源。
在不理解问题的情况下写出的计划,不过是伪装成文档的猜测。/dr-prd 命令的存在就是为了消除这一差距。它运行结构化的发现流程,并生成一份产品需求文档——即 PRD——其中明确需要构建什么、为什么构建,以及有哪些约束条件。流水线中的每一个后续阶段都可追溯回它。
该命令接收在 /dr-init 期间分配的任务 ID,并分三个阶段推进。阶段 1 通过读取现有项目文件和相关代码来收集上下文。阶段 2 进行发现访谈,以挖掘需求和约束。阶段 3 生成 PRD 本身、保存它,并针对过程中识别出的任何子问题提出待办事项。
它的作用
阶段 1 的上下文收集会读取项目简报文件、技术上下文和系统模式文件。对于 Level 2 及以上的任务,访谈前会运行一次可选的研究环节——它会启动一个研究员 agent,查找与任务相关的外部文档、库行为或既往发现。结果会写入一个洞察文件,供访谈随后使用。
阶段 2 的发现访谈会根据复杂度进行调整。针对较简单任务的快速访谈会提出关于范围和约束的聚焦问题。针对复杂任务的深度访谈会探讨用户影响、系统边界和集成点。输出是一份结构化的需求摘要,直接输入 PRD。
阶段 3 会针对问题生成至少三种不同的技术方案,每种方案都有明确的优缺点,并按照四项标准评分:安全性、与现有模式的一致性、避免重复以及可测试性。在向操作员呈现这些方案以供决策后,该命令会将 PRD 写入 datarim/prd/,并在保存前验证每一条验收标准的路径。
一个具体示例
一个为公共 API 添加限流层的任务会按如下方式经过该命令。阶段 1 读取现有的 API 处理程序代码,并发现项目中已有 Redis 实例。阶段 2 询问可接受的限制、错误行为,以及限制应按用户还是按 IP 计算。阶段 3 生成三种方案——内存计数器、Redis 滑动窗口和网关规则——并对它们评分。Redis 滑动窗口胜出,因为它复用了现有基础设施,并且能在进程重启后继续生效。该决策及其理由会出现在 PRD 的“技术方案”部分,并附有一条验收标准:限流器在达到配置阈值后返回 HTTP 429。
它在流水线中的位置
对于 Level 3 和 Level 4 任务,该命令在 /dr-init 之后运行。Level 1 任务完全跳过它;当规划较为直接时,Level 2 任务也可以跳过它。此处生成的 PRD 会成为 /dr-plan 的参考文档,后者将已批准的方案拆解为实施步骤;它也会成为 /dr-qa 的参考文档,后者会对照所述需求检查最终实现。
还有一个期望合并步骤。PRD 保存后,该命令会将由成功标准衍生出的新期望追加到 /dr-init 期间创建的期望文件中。这样就能让操作员的意图从简报一直可追溯到验证,而无需重写任何已有内容。
如需了解更广泛的背景,请参阅什么是 Datarim,或阅读关于/dr-plan 命令的内容,该命令会将 PRD 转化为实施计划。