SuperAPI AI 工具集

prototype

编程与开发

查看项目

更新于 11-07 16:46

技能介绍

Prototype 是一个构建一次性原型来回答设计问题的技能。其核心思路是:原型是用于回答问题的临时代码,问题的类型决定原型的形态。

用途 当用户想检验某个状态模型或业务逻辑是否合理,或者想探索界面应该呈现什么样子时,可使用此技能,在投入正式实现前快速获得验证。

主要能力 技能根据提示、周边代码或询问用户来确定要回答的问题,并选择分支:

逻辑分支(LOGIC.md):“这个逻辑/状态模型感觉对吗?”——生成单个可分享的 HTML 文件,包含自由操作按钮和分步引导,把状态机推过纸上难以推理的情况,非开发者也能操作。

界面分支(UI.md):“这个应该长什么样?”——在单一路由上生成多个差异明显的 UI 变体,可通过 URL 搜索参数和底部浮动栏切换。

两个分支产出的产物差异很大,若问题确实模糊且无法联系用户,则根据周边代码选择更匹配的分支(后端模块选逻辑,页面或组件选界面),并在原型顶部说明假设。

通用规则

  • 从一开始就明确是一次性代码并清楚标记,放在实际使用位置附近,命名让普通读者能看出是原型而非生产代码;临时 UI 路由遵循项目既有路由约定。
  • 运行简单:UI 原型通过项目任务运行器的一条命令启动,逻辑演示是用户双击即可打开的单个 HTML 文件。
  • 默认不持久化,状态保存在内存中;若问题明确涉及数据库,则使用临时数据库或带有明确“PROTOTYPE, wipe me”名称的本地文件。
  • 不做打磨:不写测试,不做超出可运行范围的错误处理,不做抽象。
  • 展示状态:每次操作后或每次变体切换时,打印或渲染完整相关状态。
  • 完成后捕获:将验证过的决策并入正式代码,把原型提交到一次性分支并离开主分支,在实现议题上留下指向该分支的上下文指针,并记录结论及其解决的问题;主分支只保留验证后的决策。

适用场景 适合在正式实现前快速验证状态模型、业务逻辑或界面方向。限制在于原型本身不追求生产质量,不包含测试与完善错误处理,默认不持久化状态。