SuperAPI AI 工具集

prototype

设计与创作

查看项目

更新于 10-16 03:49

技能介绍

用途:用丢弃式原型快速回答一个设计问题,而不是交付生产代码。问题的类型决定原型的形态。

先分支。根据用户提示或周边代码判断所回答的问题:“这套逻辑/状态模型是否合理?”对应 LOGIC.md,生成单个可分享的 HTML 文件(自由操作按钮加标签页式引导演练),把状态机推到纸面上难以推理的情况,并让非开发者也能操作。“界面应该长什么样?”对应 UI.md,在同一路由上生成多个差异明显的 UI 变体,通过 URL 搜索参数和底部浮动栏切换。若问题确实模糊且无法联系用户,则按周边代码倾向选择分支(后端模块偏逻辑,页面或组件偏界面),并在原型顶部写明该假设。

共同规则:从第一天起就是丢弃式并明确标注;代码放在实际会被使用的模块或页面旁边以便体现上下文,但命名要让普通读者看出它是原型而非生产代码;丢弃式界面路由遵循项目既有路由约定,不新造顶层结构。运行要极其简单:UI 原型通过项目任务运行器的一条命令启动,如 pnpm <name>、python <path>、bun <path>;逻辑演示是用户双击即可打开的单 HTML 文件。默认不做持久化,状态保存在内存中;若问题明确涉及数据库,则使用临时数据库或名字里清楚写明“PROTOTYPE, wipe me”的本地文件。不做打磨:不写测试,除让原型能跑起来外不做错误处理,不做抽象。要暴露状态:每次操作(逻辑)或每次切换变体(界面)后,打印或渲染完整的相关状态。完成后收尾:把验证过的决定并入真实代码,再把原型本身作为一手资料保存——提交到主分支之外的丢弃式分支,并在实现 issue 上留下指向该分支的上下文指针;同时把答案(结论及其所解决的问题)记录在 issue 或提交中,主分支只保留已验证的决定。限制:资料未提供具体工具链、依赖、性能指标或收费信息。