命令 Pipeline

/dr-prd

为 L2+ 任务生成包含结构化研究阶段(阶段 1.3)的 PRD

概述

/dr-prd 遵循增强设计流程生成结构化的产品需求文档。它会解析目标任务、分析现有代码与项目上下文、研究外部上下文(针对 L2+ 任务)、执行发现访谈、探索多种技术方案,并产出一份包含明确范围、约束和成功标准的文档。

用法

/dr-prd "用户通知系统"
/dr-prd "将数据库迁移至 PostgreSQL"

工作方式

  1. 分析上下文(阶段 1) — 读取 projectbrief.md、techContext.md、systemPatterns.md 及相关源代码,以理解约束条件。
  2. 研究(阶段 1.3) — 针对 L2+ 任务,启动一个研究者智能体,调查库版本、最佳实践、CVE、兼容性和技术栈文档。产出 datarim/insights/INSIGHTS-{task-id}.md。L3-L4 任务使用 10 点完整清单;L2 任务使用 5 点精简版。L1 快速修复跳过研究。
  3. 发现访谈(阶段 1.5) — 按复杂度执行聚焦访谈:L1-2 为快速版,L2-3 为标准版,L3-4 为深度版。在提出答案前先阅读洞察文档(如可用)。应用代码库优先规则,优先采用现有模式。
  4. 探索方案(阶段 2) — 生成 3 种以上不同的技术方案,并针对安全性、模式一致性、DRY 和可测试性逐一评估。拒绝包含反模式的方案。
  5. 咨询用户(阶段 3) — 清晰呈现备选方案,并等待用户对选定方案予以批准。
  6. 生成 PRD — 将文档写入 datarim/prd/PRD-{slug}.md,内容包括问题陈述、范围、技术方案、备选方案、成功标准和风险。如可用,引用洞察文档。
  7. 生成待办事项 — 可选地从 PRD 中提取可执行项,并提出带有正确任务 ID 的新待办条目。

参数

对要记录的功能或任务的简要描述。

输出

创建:datarim/prd/PRD-{slug}.md。可选地用提取的条目更新 datarim/backlog.md。

PRD 结构

  • 包含现有代码洞察的上下文与分析
  • 包含选定方案及已考虑备选方案(优缺点)的技术方案
  • 包含缓解策略的安全与技术风险
  • 可衡量的成功标准

示例会话

> /dr-prd "实时通知系统"

阶段 1:分析上下文...
  读取:projectbrief.md、techContext.md、systemPatterns.md
  发现:Express.js 后端、React 前端、未配置 WebSocket

阶段 1.5:发现访谈
  问:通知是否应跨会话持久化?
  问:预期量级——每分钟数十条还是数千条?

阶段 2:探索方案...
  方案 A:使用 Socket.io 的 WebSocket
  方案 B:服务器发送事件(SSE)
  方案 C:轮询加长轮询回退

  推荐:方案 A(最契合双向通信需求)

阶段 3:等待您的批准...

PRD 已保存至:datarim/prd/PRD-notification-system.md

PRD 识别出 4 个潜在待办条目:
  1. NOTIF-NNNN:WebSocket 服务器搭建
  2. NOTIF-MMMM:通知存储层
  3. NOTIF-PPPP:React 通知组件
  4. NOTIF-QQQQ:推送通知集成
添加到待办事项?(y/n)

相关命令

  • /dr-init — 必须在 /dr-prd 之前运行
  • /dr-plan — 下一阶段:实施规划
  • /dr-design — 针对 L3-4 的深度设计探索

报告结果

在面向人工的更新或结果之前,应用人类成果报告。说明用户可见的结果、原始条件、检查与证据,以及未解决的限制。阶段结果并不意味着整个任务已完成。保持精确的协议和技术记录完整。如需在不继续工作的情况下再次解释,请使用 /dr-explain。