SuperAPI AI 工具集

prototype

设计与创作

查看项目

更新于 10-15 17:31

技能介绍

用途:在投入生产代码前,用一次性原型回答一个明确问题。原型不是功能本身,唯一需要保留的是问题答案。

主要能力:分为两个分支。逻辑分支适用于状态机、领域模型、算法、API 形态、解析、校验、持久化行为或业务规则,用终端脚本、类单元测试脚手架、REPL 命令或小型本地服务构建最小可运行模型,并把重要状态、转换、不变量和失败场景直接编码进去。UI 分支适用于页面、组件、视觉层级、交互模型、内容布局或产品流程对比,在同一路由、页面或本地预览面上放置若干有实质差异的变体,用标签页、开关、查询参数或分段控件切换。

使用方式:在原型笔记或最终回复顶部写明所答问题、所选分支、分支不明确时的假设,以及什么结果会让原型有用。将工作隔离在仓库的 scratch/prototype 约定中;若没有,优先使用 docs/prototypes/<slug>/、prototype/<slug>/ 等明显一次性的本地目录。尽量使用现有运行时和任务运行器,原型能用一条命令运行。除问题涉及持久化外,状态保持在内存中;若涉及持久化,使用带 PROTOTYPE-wipe-me 名称的临时数据库或本地文件。避免引入宽泛的新依赖,只有直接回答问题时才加一个且便于移除。把答案记录在最终回复、父工单、父规格、ADR 或原型旁的 NOTES.md 中。

限制:不要编辑生产路径,除非问题只能在真实应用外壳内回答;若必须改动,保持 diff 易于删除。逻辑分支在模型证明或证伪设计后即停止,不要围绕它构建 UI。UI 分支应优先展示分歧选项与取舍,而非细微视觉调整。当用户要求从探索转向实现时,删除原型或标记为一次性。

输出报告:原型路径与运行命令、所用分支及原因、从原型学到的答案、应保留/丢弃/转化为生产工作的内容,以及仍存在的不确定性。