Prototype 是一个用于在正式投入设计前构建一次性原型以验证设计方案的技能。其核心理念是:原型是回答某个问题的一次性代码,问题的类型决定原型的形态。
用途 在确定设计方向前,用一次性代码快速验证关键疑问,避免在错误方向上投入正式开发。
分支选择 根据用户提示、周边代码或直接询问用户,判断要回答的是哪类问题:
- “这段逻辑/状态模型是否合理?”→ 逻辑分支:构建一个微型可交互终端应用,把状态机推过那些难以在纸上推演的情形。
- “界面应该长什么样?”→ UI 分支:在单一路由上生成多个差异明显的 UI 变体,通过 URL 搜索参数和底部浮动栏切换。 两个分支产出的产物差别很大,选错会浪费整个原型。若问题确实模糊且无法联系到用户,则默认选择与周边代码更匹配的分支(后端模块选逻辑,页面或组件选 UI),并在原型顶部注明该假设。
通用规则
- 从第一天起就是一次性的,并明确标注为原型。原型代码放在实际使用位置附近,便于理解上下文,但命名要让普通读者一眼看出是原型而非生产代码。一次性 UI 路由应遵循项目已有的路由约定,不要发明新的顶层结构。
- 一条命令即可运行:使用项目已有任务运行器支持的方式,如 pnpm <name>、python <path>、bun <path> 等,用户无需思考即可启动。
- 默认不做持久化:状态保存在内存中。持久化是原型要检验的对象,而不是它应依赖的东西。若问题明确涉及数据库,则使用临时数据库或命名清晰的本地文件(如“PROTOTYPE — wipe me”)。
- 跳过打磨:不写测试,除保证可运行外不做错误处理,不做抽象。目标是快速学到东西然后删除。
- 展示状态:逻辑分支在每次操作后、UI 分支在每次切换变体时,打印或渲染完整的相关状态,让用户看到变化。
- 用后删除或吸收:原型回答完问题后,要么删除,要么把验证过的决策并入正式代码,不要留在仓库里腐烂。
完成之后 用户确认或否决原型后,在继续之前完成两步:
- 记录决策:将问题、学到的结论、胜出的方案写入持久位置——ADR、issue 评论、提交信息或 CONTEXT.md。
- 删除所有原型文件:若用户想吸收部分内容进正式代码,先吸收,再删除其余部分。任何原型文件都不应比它所服务的决策存续更久。
适用场景 适用于正式开发前需要快速验证状态模型、业务逻辑或界面方向的场景,尤其是那些难以在纸上推演或需要直观感受的问题。
限制 该技能产出为一次性代码,不适合直接作为生产代码使用;不提供持久化、测试、错误处理或抽象等工程化能力;需配合项目已有任务运行器和路由约定使用。具体支持的命令、平台与配置细节暂未提供。