用途:Prototype 是用于回答一个设计问题的一次性代码,问题决定原型的形状。它适合在用户想验证某个状态模型或逻辑是否感觉对,或想探索界面应该长什么样时使用。
主要能力:先识别要回答的问题,来自用户提示、周围代码,或用户在线时直接询问。问题为“这套逻辑/状态模型感觉对吗”时走 LOGIC.md 分支,构建单个可分享的 HTML 文件,用自由操作按钮与分标签引导式走查,让状态机跑过纸面上难以推理的情况,非开发者也能驱动。问题为“这应该长什么样”时走 UI.md 分支,在单一路由上生成几种差异很大的界面变体,通过 URL search param 和浮动底栏切换。两个分支产物差异很大,选错会浪费整个原型。若问题模糊且用户不可达,默认选更匹配周围代码的分支,并在原型顶部说明假设。
使用方式:从第一天就是一次性产物并明确标记,命名要让人看出不是生产代码。代码放在被原型化的模块或页面旁边,一次性 UI 路由遵守项目现有路由约定。界面原型从项目任务运行器的一条命令启动,如 pnpm <name>、python <path>、bun <path>;逻辑演示是双击即可打开的单个 HTML 文件。默认不持久化,状态保存在内存中;若问题涉及数据库,用临时数据库或带“PROTOTYPE, wipe me”名称的本地文件。暴露状态:每次操作或切换变体后,打印或渲染完整相关状态。跳过打磨:不写测试、不做超出能跑所需的错误处理、不做抽象。
限制与完成:完成后把验证过的决策折进真实代码,把原型本身作为主要来源保存,提交到 main 之外的临时分支,并在实现 issue 上留下指向该分支的上下文指针,同时记录结论与它解决的问题;main 只保留验证过的决策。资料未提供具体命令名、分类归属依据、适用项目类型或平台限制等更多细节。