SuperAPI AI 工具集

emil-build-a-tool

编程与开发

查看项目

更新于 11-16 23:26

技能介绍

用途

这个技能面向一类常见场景:用户想要一个具体产物,但直接用提示词生成总是“差一点”,每次尝试都要往返一轮,结果接近却无法精确控制。技能的思路是不直接生成产物,而是先构建产出该产物的工具,把一次性碰运气的过程变成可反复微调的旋钮。技能强调严格按顺序执行两个半程:诊断,然后构建。最常见的失败是跳过诊断、直接做一个通用试验台。工具的价值在于针对“直接路径为何失败”的具体原因,因此找到这个原因才是真正的工作。

第一阶段:诊断缺口

在提出任何方案前,先从对话中回答四个问题,只向用户询问无法推断的信息:最终要交付什么(指明产物及其在项目中的位置,工具本身永远不是它);为什么不能直接构建(分析核心,对缺口分类);谁知道这个过程(产出参考的应用、有名称的技术、规格说明或现有实现,工具应复现已知可行的过程而非凭空发明);项目需要什么格式(答案取决于代码要拿输出做什么,如性能、交互性、文件大小,而不是哪种格式最好导出)。

缺口分类

技能给出一个判断树,按“提示词为何总是打不中”分类:结果依赖只有用户眼光能做的判断(密度、平衡、颜色、“感觉对了”),对应调参工具,重建过程并把每个审美取值绑定到实时控件;结果必须匹配已存在的东西(设计稿、另一个应用的输出、参考图),对应匹配工具,复现产出参考的过程,并在同尺寸下并排渲染;结果存在但形式不对(像素对但格式错、数据对但结构错),对应转换器,读取来源并导出项目所需格式;结果只能在难以到达的状态下评判(特定屏幕、数据集、视口、交互中的某一刻),对应舞台,提供一条能每次瞬间进入该状态的路由;还没有目标、用户在探索中看到才知道要什么,则不属于匹配,应转交给 emil-get-creative 技能。多数真实工具会组合两个分支,需明确说出所提议的组合。

何时不该建工具

如果一两次直接尝试就能得到产物,就直接构建,工具是额外开销;如果结果完全确定、没有判断空间,直接构建即可;如果不确定属于哪种情况,先做一次诚实的直接尝试。技能还给出“停止循环”规则:如果已经出现一轮“更接近但还不对”,诊断已经完成,这轮循环就是证据,应明确指出并提议建工具,而不是换个说法悄悄重试。

第二阶段:提出工具

写代码前,用固定格式简短说明:缺口(一句话说明直接路径为何失败)、工具(渲染什么、属于哪类或哪几类组合)、控件(哪些决策属于用户的眼光)、导出(项目将导入的确切格式及保存方式)。工具体现了对问题的理解,此刻是用户纠正理解成本最低的时机。若用户在场,留出改口的时间;若用户已让直接开始,则说明方案后立即构建。

第三阶段:构建

一次完成,不搞仪式感,它是脚手架而非产品:使用隔离路由(如 /lab/<slug> 或项目等价路径),生产环境不从中导入,后续提升的是保存的输出与整理后的渲染逻辑;重建过程而非输出,写渲染函数前先命名技术,若参考来自现有应用,其设置面板就是参数列表,视为已被验证;目标物保持可见,若有参考,按最终发布尺寸并排渲染,避免靠记忆在标签页间切换来匹配;每个判断点都是实时控件,不确定的数字不要硬编码,应绑定为控件,固定值只用于过程的规则,给每个控件测试过的边界,防止滑块到达损坏渲染的状态;即时反馈,控件移动即重新渲染,不应有“应用”步骤,若使用 leva 等面板库,保持每行无条件渲染,避免在文件夹内条件渲染破坏布局;保存写入文件,一个按钮把当前完整配置以 JSON 持久化到项目中(若导出数据独立则一并保存),并在界面显示写入路径,生产环境导入该文件,让保存即交付决策,避免靠面板目测导致发布版本漂移。完成后用两行交付 URL 和动词即停,微调属于用户。

第四阶段:收获

用户选定后,读取保存的配置与导出,绝不从面板肉眼抄值;把导出与整理后的渲染逻辑接入真实产物;除非被要求移除,保留工具,以便同一视觉语言的下一份资产继续复用。

调用变体

技能列出多种调用方式:<卡住的东西> 执行完整流程(诊断→建议→构建→交付);diagnose 只执行第一、二阶段,分析并建议工具但不构建;harvest 读取最近保存的配置并接入真实产物;harvest <path/to/config.json> 从指定配置执行同样操作;more knobs 把当前工具中硬编码的值提升为控件;export as <format> 增加或替换导出器。

限制

资料未提供该技能的具体运行平台、依赖、安装命令、收费方式或效果数据,暂未提供。正文中的分类与流程均来自技能说明本身,实际使用需在支持该技能的环境中调用。