SuperAPI AI 工具集

prototype

通用与其它

查看项目

更新于 10-16 04:33

技能介绍

用途:prototype 用于构建一次性原型,在正式投入某个设计之前先把问题弄清楚。它认为原型是回答问题的丢弃式代码,问题的类型决定原型的形态。

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

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

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

限制:资料未提供具体安装命令、依赖要求、支持平台、收费方式或效果数据,这些暂未提供。