SuperAPI AI 工具集

prototype

编程与开发

查看项目

更新于 10-15 19:54

技能介绍

用途:构建一次性(throwaway)原型来回答某个设计问题。当用户想验证状态模型或逻辑是否合理,或想探索界面应该长什么样时使用。该技能从 mattpocock/skills(MIT)导入,上游为模型调用。

主要能力与分支:先判断要回答的问题,再选择分支。若问题是“这套逻辑/状态模型感觉对吗”,走 LOGIC.md:构建单个可分享的 HTML 文件,包含自由操作按钮和分标签的引导式走查,把状态机推过纸面上难以推理、且非开发者也能操作的情形。若问题是“这应该长什么样”,走 UI.md:在单个路由上生成多个差异很大的 UI 变体,通过 URL 查询参数和底部浮动栏切换。两个分支产物差异很大,选错会浪费整个原型;若问题确实含糊且联系不到用户,则按周边代码默认选择(后端模块→逻辑;页面或组件→UI),并在原型顶部写明该假设。

通用规则:从第一天起就是一次性代码并明确标注;原型代码放在实际使用位置附近,但命名要让普通读者看出是原型而非生产代码;一次性 UI 路由遵循项目既有路由约定,不新造顶层结构。运行要简单:UI 原型从项目任务运行器的一条命令启动(如 pnpm <name>、python <path>、bun <path>),逻辑演示是双击即可打开的单 HTML 文件。默认不做持久化,状态存内存;若问题明确涉及数据库,则用临时库或带“PROTOTYPE, wipe me”名称的本地文件。跳过打磨:不写测试,除可运行所需外不做错误处理,不做抽象。暴露状态:每次操作(逻辑)或每次变体切换(UI)后打印或渲染完整相关状态。完成后收尾:把已验证的决策并入真实代码,再将原型本身作为一手来源提交到一次性分支(不留在 main),并在实现 issue 上留下指向该分支的上下文指针;同时把结论(判定及其解决的问题)记录在 issue 或提交中,main 只保留已验证的决策。

用法与限制:先在一个窄范围应用,确认输出符合上述形态后再扩展到完整任务;需要仓库或环境事实时自行查找而非询问用户。保持上游流程完整,偏离需显式记录;在技能标记为用户决策的每个点停下交还控制权;优先小而可逆的改动,写明假设。参考资料包括上游 SKILL.md(commit 3cca18b,MIT)、references/LOGIC.md、references/UI.md、项目标准 .agent-skills/skill-standardization/SKILL.md 及校验脚本 .agent-skills/skill-standardization/scripts/validate_skill.sh。具体收费、平台与效果暂未提供。