SuperAPI AI 工具集

prototype

编程与开发

查看项目

更新于 10-18 16:15

技能介绍

Prototype 是一个用于构建一次性原型以回答设计问题的技能。它的核心理念是:原型是“用完即弃的代码”,其形态由所要回答的问题决定。

用途 该技能用于在开发过程中快速验证设计问题,而不是产出可交付的生产代码。它适用于两类典型场景:一是想确认某个状态模型或逻辑是否合理,二是想探索界面应该长什么样。

主要能力 技能首先要求识别正在回答的是哪个问题,依据用户提示、周边代码,或在用户在场时直接询问。

分支一:逻辑与状态模型(LOGIC.md) 当问题是“这段逻辑 / 状态模型感觉对吗”时,构建一个可分享的单个 HTML 文件,包含自由操作按钮以及分标签的引导式演练。它把状态机推过那些难以在纸面上推理、且非开发者也能驱动的用例。

分支二:界面外观(UI.md) 当问题是“这应该长什么样”时,在单个路由上生成多个截然不同的 UI 变体,通过 URL 搜索参数和浮动底栏进行切换。

两条分支产出的产物差异很大,因此选错分支会浪费整个原型。如果问题确实模糊且无法联系到用户,则默认选择与周边代码更匹配的分支(后端模块对应逻辑,页面或组件对应 UI),并在原型顶部说明该假设。

使用方式 适用于两条分支的通用规则如下:

  • 从第一天起就是一次性代码,并清楚标记。把原型代码放在它实际将被使用的位置附近(紧邻它所原型化的模块或页面),让上下文显而易见,但命名要让普通读者能看出它是原型而非生产代码。对于一次性的 UI 路由,遵循项目已有的路由约定,不要发明新的顶层结构。
  • 运行要极其简单。UI 原型从项目任务运行器的一条命令启动:pnpm <name>、python <path>、bun <path> 等。逻辑演示是用户双击即可打开的单个 HTML 文件。无论哪种方式,启动都不需要思考。
  • 默认不做持久化。状态保存在内存中。持久化是原型要检验的东西,而不是它应该依赖的东西。如果问题明确涉及数据库,则使用临时数据库或带有明确“PROTOTYPE, wipe me”名称的本地文件。
  • 跳过打磨。没有测试,没有超出让原型可运行所需的错误处理,没有抽象。重点是快速学到东西。
  • 展示状态。每次操作(逻辑)后或每次变体切换(UI)时,打印或渲染完整的相关状态,让用户看到发生了什么变化。
  • 完成后捕获。把任何已验证的决策并入真实代码,然后把原型本身作为一手资料捕获:提交到一次性分支,脱离主分支,并在实现问题上留下指向该分支的上下文指针。同时把答案(结论及其所解决的问题)记录在问题或提交中。主分支只保留已验证的决策。

适用场景 适用于需要快速验证状态模型、逻辑合理性或界面设计方向的开发场景,尤其适合在正式实现前进行低成本探索。

限制 该技能明确要求原型为一次性代码,不追求生产级质量,不包含测试、错误处理或抽象。默认不做持久化。若问题模糊且无法联系用户,只能基于周边代码做默认假设。关于收费、价格、平台等信息,资料中暂未提供。