用途:针对一个会改变决策的问题,用一次性代码做实验,先陈述未知点、可回答它的观察方式以及时间或范围限制。若现有代码与文档已能回答该问题,则不需要做原型。
主要能力与形态:视觉决策先读 references/ui.md,从一个 fixture 或静态屏幕开始,只有当比较能改变决策时才用两个备选方案;只有当真实应用上下文会改变观察结果时才使用宿主页面或切换器。需要人工探索的逻辑或状态行为读 references/logic.md,使用独立 HTML 演示。技术属性(集成行为、延迟、库支持等)写小型本地脚本或测试装置,记录相关输入、输出与测量,不要添加无助于回答问题的 UI。
使用方式:直接调用时先用 shared/references/model-preview.md 选择分支;协调工作与确定性命令在调用权限内进行,实际 worker 分支使用一份已批准的路线快照,嵌套调用复用它而不重新选路线或增加 worker。把工作隔离在暂存位置或本地 worktree,命名标明为原型,给出一条运行命令或文件路径;使用安全的记忆支撑或暂存数据,仅在授权且为回答问题所必需时使用真实服务。跳过生产脚手架与无关修饰,保留足够检查与错误输出。达到约定限制而问题仍未解决时就停止。
返回内容:question(测试的单一问题)、answer(决策、证据、限制与未解决结果)、snippets(仅决策相关的状态、模式或类型形态,不宣称生产可用)、disposition(产物路径及保留或移除)。证据与调用方的决策记录或任务计划放在一起,并带决策修订或内容哈希;后续决策变更即标记相关原型被取代。视觉决策需记录真实浏览器评审后才能声称布局已验证,模型或 DOM 检查不能证明视觉可用性;无法进行浏览器评审时应保留该未决限制,不要声称已验收。制品有用可本地保留,仅在授权时提交一次性分支或更新跟踪器,清理时不删除无关文件。未解决时返回开放决策而非编造答案。
限制:原型代码永不转正,后续生产任务在其验收契约下重建所选行为;不添加收费、平台或效果等资料未提供的信息。