SuperAPI AI 工具集

prototype

通用与其它

查看项目

更新于 10-16 02:28

技能介绍

用途:prototype 用于在正式提交某个设计之前,用一次性(throwaway)代码快速回答一个具体问题。问题的类型决定原型的形态,因此第一步是选择分支。

两条分支:若问题是“这套逻辑/状态模型是否合理”,走 LOGIC.md,构建一个极小的交互式终端应用,把状态机推过那些在纸面上难以推理的用例;若问题是“这应该长什么样”,走 UI.md,在单个路由上生成多个差异极大的 UI 变体,通过 URL 查询参数和底部浮动栏切换。两条分支产物差异很大,选错会浪费整个原型。若问题确实模糊且联系不到用户,则默认选择更贴合周边代码的分支(后端模块→逻辑;页面或组件→UI),并在原型顶部声明该假设。

通用规则:从第一天起就是一次性代码并明确标注;原型代码放在实际使用位置附近(被原型化的模块或页面旁),但命名要让普通读者看出它是原型而非生产代码;一次性 UI 路由遵循项目既有路由约定,不要新造顶层结构。运行只需一条命令,使用项目现有任务运行器支持的写法,如 pnpm <name>、python <path>、bun <path> 等,用户无需思考即可启动。默认不做持久化,状态保存在内存中;持久化本身是原型要检验的对象,不应成为依赖;若问题明确涉及数据库,则使用临时数据库或带有明显“PROTOTYPE - wipe me”名称的本地文件。跳过打磨:不写测试,除让原型可运行外不做错误处理,不做抽象,目标是快速学到东西然后删除。暴露状态:每次操作(逻辑)或每次变体切换(UI)后,打印或渲染完整的相关状态,让用户看到变化。完成后删除或吸收:当原型回答了问题,要么删除,要么把已验证的决策并入真实代码,不要让它烂在仓库里。

收尾:原型唯一值得保留的是答案。把答案连同它回答的问题记录到持久位置(提交信息、ADR、issue 或原型旁的 NOTES.md)。若用户在,可快速对话确认;若不在,留下占位符,供用户或下一轮在删除原型前填写结论。

限制:资料未提供具体安装命令、依赖、收费、平台或效果信息。