SuperAPI AI 工具集

prototype

编程与开发

查看项目

更新于 10-16 03:38

技能介绍

用途:prototype 用于构建一次性(throwaway)原型,回答一个明确的设计问题。问题决定产物形态:若问题是“这套逻辑/状态模型是否合理”,走逻辑分支,产出单个可分享的 HTML 文件,含自由操作按钮与分标签的引导式演示;若问题是“界面应该长什么样”,走 UI 分支,在同一路由上给出多个差异明显的界面变体,通过 URL 查询参数和底部浮动栏切换。

主要能力:输入为一个设计问题,以及存在时的周边模块或页面;输出为可运行原型和已捕获的结论(判定结果及它回答的问题),并从实现 issue 指向该结论。原型文件放在真实模块或页面旁边,命名上明确体现是原型;捕获主要来源时使用一次性的 prototype/<name> 分支。

使用方式:先判断回答的是哪类问题,来源可以是用户提示、周边代码或直接询问。若问题确实模糊且无法联系用户,则按周边代码判断(后端模块→逻辑,页面或组件→UI),并在原型顶部说明该假设。UI 原型通过项目任务运行器的一条命令启动;逻辑演示是双击即可打开的单 HTML 文件。

限制与规则:从第一天起就是一次性产物并明确标注;默认不做持久化,状态保存在内存中;不做打磨,不写测试,除可运行所需外不做错误处理,不做抽象;每次操作(逻辑)或切换变体(UI)后都要展示完整相关状态。提交一次性分支前、以及把已验证决策并入生产代码前,需要确认。外部副作用仅限本地文件和用于捕获的 Git 分支,不做生产部署。该技能不委托其他技能,与 artifacts-builder(生产产物)和 theme-factory(视觉主题系统)不同。完成后把已验证决策并入真实代码,并将原型本身提交到 main 之外的一次性分支作为主要来源,在实现 issue 上留下指向该分支的上下文指针;main 分支只保留已验证的决策。