SuperAPI AI 工具集

prototype

设计与创作

查看项目

更新于 10-15 21:10

技能介绍

用途:在正式投入某设计之前,用一次性、可丢弃的原型回答一个具体问题。问题决定原型形态:若问“这套逻辑/状态模型是否合理”,走 LOGIC 分支,构建一个微型交互式终端应用,把状态机推到纸面上难以推理的场景;若问“这应该长什么样”,走 UI 分支,在单一路由上生成多个差异较大的 UI 变体,通过 URL 查询参数和底部浮动栏切换。分支选择错误会浪费整个原型;若问题确实含糊且联系不到用户,则按周围代码默认(后端模块→逻辑,页面或组件→UI),并在原型顶部说明该假设。

主要规则:从第一天起就是一次性代码并明确标注;原型放在实际使用位置附近,但命名让读者一眼看出不是生产代码;丢弃型 UI 路由遵循项目已有路由约定,不新增顶层结构。只用一个命令即可运行,使用项目现有任务运行器(如 pnpm <name>、python <path>、bun <path>)。默认不持久化,状态存内存;持久化是原型要检验的对象而非依赖,若问题明确涉及数据库,则用临时库或命名含“PROTOTYPE — wipe me”的本地文件。跳过打磨:无测试、无多余错误处理、无抽象。暴露状态:逻辑分支每次操作后、UI 分支每次切换变体时,打印或渲染完整相关状态。完成后删除或吸收:把验证过的决策并入正式代码,不让它烂在仓库里。

收尾:原型唯一值得保留的是答案。把答案连同它回答的问题记录到持久位置(提交信息、ADR、issue 或旁边的 NOTES.md)。用户在旁时快速对话记录;不在旁则留占位符,供其后确认再删除。该技能基于 Matt Pocock 的作品改编。