SuperAPI AI 工具集

prototype-controls

编程与开发

查看项目

更新于 11-11 05:59

技能介绍

prototype-controls 是一个面向 Replica 原型的控件创建与接线技能,用途是按原型作者的要求添加或修改配置型控件(如下拉框、滑块、输入框、开关、操作按钮),并让这些控件真正驱动应用行为,而非仅作静态展示。

主要能力方面,技能覆盖常见控件需求:比较布局变体(短分段选项或下拉选择,把选中的变体传入现有布局)、探索空态/加载/错误/有数据等场景(select 映射到页面既有状态或获批的测试数据)、调整条目数量或密度等数值(有界滑块或数字输入)、修改标题等预览文本(text/textarea 绑定渲染内容)、显示可选界面(布尔绑定可见性,checkboxGroup 用于独立多选)、切换种子数据或数据源(select 映射到获批加载器或 fixtures,保留既有加载/错误行为)、触发模拟事件(button 绑定到安全的按钮或应用自有方法)。

使用方式上,技能要求先阅读仓库中的 AGENTS.md、README 及相关组件/上下文指引,明确目标页面、每个请求变体的可观察效果,并区分原型配置与产品 UI 控件;当区分或效果不清时提出一个聚焦问题。每个变体都需具备目标页面、默认值和可观察效果后才继续。编辑前需给出紧凑映射(请求变体→控件类型→受影响的应用状态/属性/加载器),按作者参考声明、生成并接线控件,并保持单控件集形式,除非涉及多作用域或共享/页面生命周期。控件写入 public/controls.replica.json,Replica 负责注入适配器和面板 UI。

验证环节要求每次编辑后执行校验循环:确认画布服务的是当前工作树,调用 validate_controls 检查 JSON 语法、schema 及唯一 ID、默认值在选项内、条件无环等语义规则;无效则按报告路径修复并重试;有效后调用 reload_preview 加载新定义,再用 get_controls_status 等待适配器就绪,核对 origin、url、路由及每个控件的可用性、忙碌状态和错误信息。验证、重连与运行时修复总计不超过五次失败尝试,超出则报告剩余错误或超时。

效果验证需对每个请求控件提供可观察的渲染断言,覆盖默认值、重置,以及条件、失败与路由生命周期。若允许启动预览,则按仓库的画布/浏览器验证流程实际操作场景。该技能不授权安装依赖、启动或停止服务器、发布,数据源切换仅限已授权来源,实时访问、凭据和新集成需另行授权;若未打开 Replica 画布,只能按参考规则检查文件并请用户打开画布,校验状态标记为未验证。