命令 Planning

/dr-wizard

通过可恢复、每次只问一个问题的访谈构建任务规格

概述

/dr-wizard 在 /dr-prd 之前将粗略的需求简报转化为结构化的任务规格。它每次只提出一个聚焦的问题,记录每个回答,并在访谈过程中同步构建知识与依赖图。向导可以暂停和恢复,无需手动提供会话标识符,因为其状态锚定在任务 ID 上。

使用时机

  • 目标明确,但重要的需求或约束仍隐含未明。
  • 一个棘手的问题需要在返回主线程前进行简短的侧边访谈。
  • 架构选择可以从按需召开的 consilium 小组中获益。
  • 范围可能在发现阶段发生变化,下游的研究或规划必须被标记为过期。

访谈流程

  1. 恢复或开始。 向导检查现有任务状态并重放,而不是重新开始。
  2. 提出一个问题。 每个问题和回答都会追加到任务访谈日志中。
  3. 按需深入。 嵌套的侧边线程捕获对相关早期回答的引用,然后将其结论写回父问题。
  4. 记录决策。 需求、概念和决策成为图节点,通过依赖、细化或解决边连接。
  5. 最终化并验证。 向导关闭打开的深入帧,验证事件日志和图,并输出供 /dr-prd 使用的需求摘要。

持久化产物

datarim/wizard/<TASK-ID>.wizard.jsonl  # 仅追加的访谈事件
datarim/wizard/<TASK-ID>.graph.jsonl   # 概念、需求、决策

只有经过最终化并验证的向导产物才具有权威性。中断的访谈仍可恢复,但不会被当作已完成的规格来使用。

重新划定范围与自主性

需求变更会将研究、规划或两者标记为脏。向导会报告这些标记;它不会静默启动新的规划周期。在自主模式下,它从可用上下文中解决可回答的问题,并可为困难决策召集 consilium,同时同样严格的硬性门控操作边界仍然有效。

下一步

最终化后,运行 /dr-prd <TASK-ID>。PRD 阶段会使用已完成的需求摘要和图,而不是重复发现访谈。

报告结果

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