用途
prototype-options 用于在用户访谈结束后,把访谈中确定的决策转化为几个可导航的原型,让用户直观判断“这是否是我们决定的东西”。原型只展示已决定的内容,不实现完整行为,也不是代码的第一版。
主要能力
- 读取 .scratchpad/<slug>/interview-decisions.md,确保原型只反映其中已确定的决策。
- 与用户商定三件事:原型数量(默认三个)、每个原型之间变化的内容(视觉风格、布局、交互或技术路线)、每个原型必须展示的主路径(从第一个屏幕或命令到结果)。
- 准备一份所有原型共用的小型样本数据,项目有真实数据时从中提取,存放在 .scratchpad/<slug>/prototypes/。
- 为每个原型分配独立子代理并行构建,每个子代理使用干净的上下文,并收到完整简报:决策、样本数据路径、要展示的主路径、该原型的独特之处、输出位置(.scratchpad/<slug>/prototypes/<option>/)、最小技术栈(如静态 HTML 页面、小脚本或单个组件,除非该原型需要,否则不用项目构建)、时间限制(默认十分钟)。主路径可用即报告,不做打磨。
- 最终报告前停止所有启动的服务器并关闭所有浏览器,避免阻塞后续浏览器工具。报告内容包括如何打开该原型、展示了什么、省略了什么。
- 没有子代理时,在主会话中按相同限制逐个构建。
- 并排展示所有原型:如何打开、一行说明差异、环境允许时每个附一张截图;若某个原型延迟,先展示已就绪的。
- 询问用户保留哪个原型或组合哪些部分,将选择及用户拒绝的理由写入 .scratchpad/<slug>/interview-decisions.md 的独立标题下。
使用方式
- 阅读 .scratchpad/<slug>/interview-decisions.md。
- 与用户确认原型数量、变化维度、必须展示的主路径。
- 准备共用样本数据。
- 为每个原型分配子代理并行构建(或主会话逐个构建),设定时间限制。
- 清理服务器和浏览器。
- 并排展示原型并收集用户选择。
- 将选择写入决策文件。
适用场景
- 访谈决策后需要快速可视化多个方案供用户比较。
- 需要在不投入正式开发的情况下验证设计方向。
- 需要让用户直观看到主路径的多种呈现方式。
限制
- 原型只展示已决定的内容;出现的问题应询问用户,不自行加入原型。
- 原型不进入源码树,始终留在 .scratchpad/ 下。
- 每个原型有默认十分钟时间限制,主路径可用即报告,不做打磨。
- 没有子代理时只能顺序构建。
- 原型代码不用于后续构建,execute-plan-loop 的构建从规格开始,而非原型代码。