decision-gate

Decision Gate · 用户决策门

M6.2 整改：解决 v0.5.x "盲盒严重" 痛点——agent 包办所有决策。每个 phase 落盘后强制用 AskUserQuestion 让用户参与，让 DDT 从"包办式"转向"协作式"。

何时触发

任何 phase 命令的 Phase 5（汇总输出）末尾、Phase 6（emit-phase end）之前。10 个 phase command 都必须按本 skill 操作： prd / wbs / design / build-api / build-web / test / review / fix / package / report

也包括编排命令 /kickoff 中各内部 step 之间（除非用户传 --auto）。

决策门标准 4 选项

LLM 必须调用 AskUserQuestion 工具，按以下模板：

{
  questions: [{
    question: "<phase 中文名>已生成（<关键指标摘要>），如何继续？",
    header: "<8 字以内 phase 标识>",      // 如 "PRD review" / "Design review"
    multiSelect: false,
    options: [
      {
        label: "接受并继续 (Recommended)",
        description: "进入 <下一 phase 命令>",
        preview: "<本 phase 产物的 1-2 段摘要>"   // 让用户在选项面板就能扫一眼内容
      },
      {
        label: "修改某条具体内容",
        description: "我会指出哪条 + 怎么改（LLM 收到后用 --refresh 增量改）"
      },
      {
        label: "新增内容",
        description: "我有遗漏的需求/字段/约束要补充"
      },
      {
        label: "重新生成（带说明）",
        description: "整体方向不对，重写本 phase（LLM 收到后用 --refresh 重做）"
      }
    ]
  }]
}

注意：

• 第 1 个选项标 (Recommended) 让用户最快路径走完
• AskUserQuestion 自动加 "Other" 让用户填自定义文本
• preview 字段（仅单选支持）展示本 phase 关键输出，让用户不用打开文件即可决策
• 不要在 multiSelect=true 时用 preview（工具不支持）

决策事件采集（M6.2.2）

调用 AskUserQuestion 之前必须 emit decision_point：

node "$DDT_PLUGIN_ROOT/bin/emit-decision.mjs" \
  --phase <phase-name> \
  --action point \
  --options "accept|modify|add|regenerate"

收到用户答案后立即 emit decision_resolved：

node "$DDT_PLUGIN_ROOT/bin/emit-decision.mjs" \
  --phase <phase-name> \
  --action resolved \
  --user-action <accept|modify|add|regenerate|other> \
  --note "<用户备注摘要，≤200 字>"

这两条事件让 metrics-agent 后续能分析"哪个 phase 改最多次"，反馈到 baseline 调优。

决策处理逻辑

用户选择	LLM 行为
接受并继续	标 phase 完成（emit-phase end）+ 提示下一步命令；不要主动跑下一命令（让用户决定时机）
修改某条具体内容	进一步问"哪条？怎么改？"（再调一次 AskUserQuestion 或直接对话），收到后用 --refresh 增量修订；修订完再走一次决策门
新增内容	问"补充什么内容？"，收到后用 --refresh 增量新增
重新生成（带说明）	问"原因是什么？要保留什么？"，收到后用 --refresh 重生成；保留已验证的部分
Other（自定义文本）	解析用户意图，按上述 4 类映射处理；映射不上时写 blocker 等用户进一步澄清