prototype 是一个面向设计验证的一次性原型构建技能。它的核心观点是:原型是用来回答问题的临时代码,问题的类型决定原型的形态。
用途与分支选择 使用前需先识别要回答的问题,来源可以是提示、周边代码或直接询问。若问题是“这套逻辑或状态模型是否合理”,则产出一个可单文件分享的 HTML 原型,其中包含自由操作控件和引导式演示,把状态机推过那些在纸面上难以推理的用例,目标是让非开发者也能驱动它。若问题是“这个界面应该长什么样”,则在同一路由上给出若干差异极大的变体,通过 URL 搜索参数或浮动切换栏来切换。两类产物的形态差异很大,选错分支会浪费整个原型。如果问题确实模糊且无法联系用户,可按上下文默认:后端模块倾向于逻辑问题,页面或组件倾向于界面问题,并在顶部说明该假设。
共同规则 原型从第一天起就是一次性代码,并明确标记。把它放在被原型化代码旁边以便上下文清晰,但命名要确保不会被误认为生产代码。遵循项目既有的路由或模块约定,不要为它发明新的顶层结构。运行要极其简单:项目任务运行器中的一条命令,或用户双击即可打开的单个 HTML 文件,不需要额外设置思考。默认不做持久化,状态保存在内存中;持久化通常正是要验证的对象,而不是可以依赖的东西。如果问题确实涉及数据库,使用命名明显可丢弃的临时数据库。跳过打磨:不写测试,不做超出可运行范围的错误处理,不做抽象;test-driven-development 不适用于此,因为该代码注定要被删除,而 TDD 的铁律针对生产代码。每次操作后渲染或打印完整相关状态,让用户清楚看到发生了什么变化。
完成后的处理 把验证过的决策并入真实代码。保留原型本身作为一手来源:将其提交到以 main 为起点的临时分支,永不合并。然后在 docx/prototypes/<question-slug>.md 中记录结果,包括所问的问题、结论以及存放代码的分支。没有写下答案的原型等于要建两次。如果结论是难以逆转的架构选择,则通过 domain-modeling 将其升级为 ADR。主分支保留决策,永不保留原型。