SuperAPI AI 工具集

gs-prototype

编程与开发

查看项目

更新于 11-15 17:33

技能介绍

gs-prototype 用于构建一次性原型,以回答某个设计问题。其核心理念是:原型是回答问题的丢弃式代码,问题的性质决定原型的形态。

用途与分支选择 使用时会借助用户提示、周边代码,或在用户在线时直接询问,判断正在回答哪个问题,并据此选择分支:

  • 若问题是“这套逻辑/状态模型感觉对吗?”,走 LOGIC.md 分支:构建单个可分享的 HTML 文件,包含自由操作按钮和分标签的引导式走查,把状态机推过那些在纸面上难以推理的用例,并让非开发者也能操作。
  • 若问题是“这应该长什么样?”,走 UI.md 分支:在单个路由上生成若干个差异显著的 UI 变体,通过 URL 搜索参数和底部浮动栏切换。 两条分支产出的制品差异很大,选错会浪费整个原型。若问题确实有歧义且无法联系到用户,则默认选择与周边代码更匹配的分支(后端模块对应逻辑分支,页面或组件对应 UI 分支),并在原型顶部说明该假设。

通用规则

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

适用场景与限制 适用于对状态模型或逻辑做快速合理性检验,或探索界面应呈现何种样貌。原型不用于生产,不含持久化、测试与打磨,因此不适合直接作为交付代码或依赖其数据留存。

其他信息(如收费、具体平台支持)暂未提供。