SuperAPI AI 工具集

prototype

通用与其它

查看项目

更新于 10-16 05:45

技能介绍

用途:prototype 用于构建一次性原型,在正式确定设计前先验证某个问题。它强调“原型是回答问题的可丢弃代码”,问题的类型决定原型的形态。

主要能力:技能会先判断要回答的问题,分为两条分支。若问题是“这套逻辑或状态模型是否合理”,走 LOGIC.md 分支,构建一个极小的交互式终端应用,把状态机推过那些在纸面上难以推理的用例。若问题是“界面应该长什么样”,走 UI.md 分支,在单个路由上生成多个差异很大的 UI 变体,通过 URL 查询参数和底部浮动栏切换。

使用方式:两条分支产出的产物差异很大,选错会浪费整个原型。若问题确实模糊且无法联系用户,则默认选择更贴合周边代码的分支(后端模块走逻辑,页面或组件走界面),并在原型顶部说明该假设。两条分支共同规则包括:从第一天起就明确标记为可丢弃;原型代码放在实际使用位置附近,但命名要让普通读者看出是原型而非生产代码;UI 路由遵循项目既有路由约定,不新造顶层结构;提供一条命令即可运行,如 pnpm <name>、python <path>、bun <path> 等;默认不做持久化,状态保存在内存中,若问题涉及数据库则使用临时库或带“PROTOTYPE — wipe me”标记的本地文件;跳过打磨,不写测试、不做多余错误处理与抽象;每次操作或切换变体后展示完整相关状态;完成后删除或把验证结论并入真实代码。

适用场景:适合在提交设计前快速验证状态模型或界面方向。限制:资料未提供具体安装命令、收费、平台支持或效果数据;原型本身不应保留在仓库中,其价值仅在于得出的结论,需记录到提交信息、ADR、issue 或 NOTES.md 中。