概览
dsh-clarify
Ask first, build once: an opt-in clarification mode that makes the agent interview you before it starts, then work against a requirement card you approved. 澄清模式：开工前先把需求问清楚——结构化提问、默认值、需求卡确认。
README / ZH
插件文档
目录摘要
Ask first, build once: an opt-in clarification mode that makes the agent interview you before it starts, then work against a requirement card you approved. 澄清模式：开工前先把需求问清楚——结构化提问、默认值、需求卡确认。
dsh.pub 核对固定版本的组合包契约、运行时事实与分发语义；完整 README 请查看源仓库。
在 GitHub 阅读完整 READMELIMITATIONS
已知限制
- **约束是提示词级的，不是沙箱。** 「澄清阶段只读不写」靠指令和确认门，插件不拦 `write`/`bash`。 - **本机进程受信任。** 见「安全边界」：同机的 curl 级别调用仍能读卡片、答问题；插件防的是跨站与局域网匿名访问。 - **面板靠心跳判定在线。** 面板 15 秒内没轮询，宿主就认为没有面板，退回内置问答（一次一题）。所以面板只由 `conversation.input.dock` 里的组件启动轮询——胶囊按钮只读一次状态，绝不冒充心跳。 - **超时会退回聊天。** 面板 20 分钟没人答（`interviewTimeoutMs`），工具返回 `timeout`，模型会把问题整理成一段话贴到回复里。 - **子 Agent 里不能确认**，会拿到 `no_client`，不会卡死。 - **状态按 session id 记**，fork/重命名成新 id 后不带模式；重新点一下开关即可。 - **「已开工」只在当前进程内记。** 它来自 `session/event` 的写文件类工具调用，重启后从头判断；`bash` 不算开工（它可能只是 `ls`），所以用 bash 生成的交付物不会触发 goal 过滤。 - **指标是本地文件，不是遥测。** 记录写在 `$DSH_HOME/clarify/metrics.json`，最多 500 条；`invalid`/`busy` 这类没有真实访谈的尝试不记录。 - **提示词是中文写的**，英文会话能跑，但模型会用中文问。 ---