SuperAPI AI 工具集

prototype

设计与创作

查看项目

更新于 10-16 09:28

技能介绍

用途:这是一个用于构建一次性(throwaway)原型的技能,目的是回答某个具体设计问题。原型代码从第一天起就应明确标记为原型、非生产代码,放在实际使用位置附近,遵循项目现有路由与任务运行约定。

分支选择:若问题是“这套逻辑或状态模型是否正确”,走 LOGIC.md 分支,构建一个极小的交互式终端应用,把状态机推过难以纸上推理的用例;若问题是“它应该长什么样”,走 UI.md 分支,在单个路由上生成几个差异明显的界面变体,用 URL 查询参数和悬浮底部栏切换。分支选错会浪费整个原型;若问题确实模糊且无法联系用户,默认选择更贴合周边代码的分支(后端模块→逻辑;页面或组件→界面),并在原型顶部说明该假设。

通用规则:一条命令即可运行,使用项目现有任务运行器(如 pnpm <name>、python <path>、bun <path>);默认不做持久化,状态保存在内存中,如问题明确涉及数据库,可用临时库或命名清晰标记为可清除的本地文件;不做打磨,不写测试、不做超出可运行所需的错误处理、不做抽象;每次动作后或每次变体切换时展示完整相关状态;完成后删除或把已验证的决策并入真实代码。

收尾:原型唯一值得保留的是答案。应把它与所回答的问题一起记录到持久位置,如提交信息、ADR、issue 或原型旁的 NOTES.md。用户在场时可口头确认,不在场则留下占位内容待填。

限制:当工作流指定上游工具、账号、API 密钥或本地环境时,需要具备这些条件;未经用户明确批准,不得执行破坏性、生产、付费或对外发消息的操作;生成物或建议应先在用户真实来源上验证后再视为最终结果。