SuperAPI AI 工具集

taste-code-craft

前端与建站

查看项目

更新于 10-18 16:13

技能介绍

taste-code-craft 是一套面向 AI 智能体构建界面的代码级工艺规范,核心主张是“设计好的页面就是设计好的代码库”,DOM 是写下的第一层布局,应按布局来组织。

用途与定位:该技能用于约束智能体生成 UI 代码时的结构、样式与交付质量,提供可逐条核对的规则与检查清单,而非具体框架或工具。

主要能力:

  • 语义化 HTML:每页一个 h1,标题层级不跳级;用 nav、main、带 aria-labelledby 的 section、figure、time、button、a href 等承载语义;列表用 ul/ol;图片必须有 alt 与显式宽高;输入控件必须有可见 label 或 aria-labelledby。页面缺 main、有无标题的 section、可点击 div 均视为不合格。
  • 令牌优先于字面值:颜色、间距、圆角、阴影、字号均取自变量,组件规则中零硬编码十六进制色;调色板与设计读出一致;字号用声明的 rem 或流体 clamp 尺度;断点来自单一媒体查询约定;有设计系统时组件消费语义令牌,不得越过它直接使用原始值。
  • 特异性与 CSS 架构:不用 !important、不用 ID 选择、不用带副作用的裸元素选择器、除单一 box-sizing 重置外不用 * 重置;嵌套深度最多 2 层;工具类系统需令牌化配置且类数量可读;交付前删除无匹配的死规则;组件单一职责。
  • 零内联样式:禁止用 style 处理布局、颜色、字体,仅允许三类例外(JS 状态注入的 CSS 变量等动态值、单个静态元素的一次性对齐、SVG 呈现属性),且需注释原因;页面内联样式超过约 5 处视为架构漂移。
  • 卫生与交付:无死标记、空元素、旧代码注释、console.log、遗留 TODO;无占位资源(lorem 文本、placehold.co、无意图的 unsplash 链接、404 图片);字体只加载一次,样式表均被使用,无复制粘贴的重复字体链接;格式统一并运行格式化工具;不引入可访问性回归(可聚焦元素可达、aria-hidden 不用于可聚焦内容、按钮不嵌套按钮)。
  • 检查清单:将可点击/导航/列表元素误用 div、令牌集外硬编码值、!important 或 ID 样式或 4 层以上嵌套、三类例外外的内联样式、未使用 CSS 或死标记或 console.log、标题跳级或重复 h1、图片无 alt 与显式尺寸、代码看起来像没读过设计系统的智能体生成——任一项触发即判失败。

使用方式:资料未提供具体安装命令、运行方式或集成接口,暂未提供。

适用场景:智能体或开发者产出前端界面代码时的质量约束、代码审查清单、设计系统落地检查。

限制:规则偏重 HTML 与 CSS 工艺约定,未提供对特定框架、构建工具或自动化检测脚本的说明;文档中提及的 taste-design-system、taste-web-performance 等关联技能细节暂未提供。