命令
Pipeline
/dr-prd
为 L2+ 任务生成包含结构化研究阶段(阶段 1.3)的 PRD
概述
/dr-prd 遵循增强设计流程生成结构化的产品需求文档。它会解析目标任务、分析现有代码与项目上下文、研究外部上下文(针对 L2+ 任务)、执行发现访谈、探索多种技术方案,并产出一份包含明确范围、约束和成功标准的文档。
用法
/dr-prd "用户通知系统"
/dr-prd "将数据库迁移至 PostgreSQL"
工作方式
- 分析上下文(阶段 1) — 读取
projectbrief.md、techContext.md、systemPatterns.md及相关源代码,以理解约束条件。 - 研究(阶段 1.3) — 针对 L2+ 任务,启动一个研究者智能体,调查库版本、最佳实践、CVE、兼容性和技术栈文档。产出
datarim/insights/INSIGHTS-{task-id}.md。L3-L4 任务使用 10 点完整清单;L2 任务使用 5 点精简版。L1 快速修复跳过研究。 - 发现访谈(阶段 1.5) — 按复杂度执行聚焦访谈:L1-2 为快速版,L2-3 为标准版,L3-4 为深度版。在提出答案前先阅读洞察文档(如可用)。应用代码库优先规则,优先采用现有模式。
- 探索方案(阶段 2) — 生成 3 种以上不同的技术方案,并针对安全性、模式一致性、DRY 和可测试性逐一评估。拒绝包含反模式的方案。
- 咨询用户(阶段 3) — 清晰呈现备选方案,并等待用户对选定方案予以批准。
- 生成 PRD — 将文档写入
datarim/prd/PRD-{slug}.md,内容包括问题陈述、范围、技术方案、备选方案、成功标准和风险。如可用,引用洞察文档。 - 生成待办事项 — 可选地从 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。