SuperAPI AI 工具集

maquina-ui-standards

通用与其它

查看项目

更新于 10-16 00:05

技能介绍

用途:在 Rails 项目中按 maquina_components 规范实现界面,覆盖功能 UI、视图与页面、带校验的表单、页面布局,以及 UI 一致性审查。

主要能力:提供组件目录与决策框架,涵盖 Card、Alert、Badge、Table、Empty、Dropdown Menu、Toggle Group、Combobox、Calendar、Date Picker、Breadcrumbs、Pagination(Pagy 集成)、Sidebar、Toast 及表单组件。组件以 ERB partial 渲染,表单元素通过 data 属性(如 data: { component: "input" })套用样式,变体用 data-variant 表达。图标使用 icon_for 助手,主题色来自 CSS 变量(--primary、--muted、--destructive 等)。

使用方式:partial 组件用 render "components/card" 等渲染;表单用 form_with 配合 data: { component: "form" },字段加 data: { component: "input" }、提交按钮加 data: { component: "button", variant: "primary" }。工作流为:读功能规格、映射所需组件、规划布局、按组件目录构建、最后对照 spec-checklist.md 检查。

核心原则:组合优于配置,可直用 partial、封装应用级组件或复制改造;优先字段内联错误加 flash 提示,而非错误列表 Alert;输入应带 type、required、maxlength、pattern、inputmode、autocomplete 等属性;样式由 data 属性驱动而非内联 Tailwind。

适用场景:Rails 应用的仪表盘、列表、表单、空状态、导航与通知等界面开发。

限制:资料未提供安装命令、版本要求、收费与价格信息;Haab 项目专属的品牌色、预订状态徽章、金额与时间显示等约定仅适用于该项目。