SuperAPI AI 工具集

eto-apere

设计与创作

查看项目

更新于 10-16 04:55

技能介绍

用途:在已确认的视觉决策与可复用令牌/组件规范之间建立实现契约,链路为“已确认原始值 → 语义用途别名 → 组件属性/状态”。不预设项目默认颜色、字体、间距、圆角、阴影、组件变体、尺寸、状态处理、动画时长或框架映射。

主要能力:先读取令牌架构,再检查项目已有令牌、主题文件、组件约定、所选 UI 库与已确认品牌方向,把现有值与已批准品牌角色作为输入。只为已确认原始值定义必要原语,并映射为 background、foreground、primary、muted、destructive、focus 及产品专属等语义角色;仅在组件属性、变体或状态需要稳定可复用契约时才添加组件令牌/规范。保留别名,避免把语义/组件引用压平为原语值;主题切换通常重映射语义别名而非重写组件。安装前校验引用、循环与 CSS 命名冲突。

使用方式:优先使用项目原生令牌编译器;否则用回退编译器:node <skill-root>/scripts/generate-tokens.cjs <tokens.json> > <temporary-tokens.css>。该编译器只负责令牌图校验与规范 CSS 生成,校验 {path.to.token} 引用、循环、CSS 命名冲突,保留 var(...) 别名,并可选输出深色语义覆盖;临时/输出路径、安装、框架映射与回读由调用方负责。兼容期内仍接受 --config、--output、--format css|tailwind 旧形式并提示弃用,--help 为普通帮助。生成产物须经项目常规变更/验证路径安装。

限制:不得编造组件解剖、变体、状态、尺寸、时长或无障碍行为;不得以通用色阶替代明确用途命名;焦点、禁用、加载、错误、选中等等状态仅在产品确实支持时才作为一等状态。框架集成属于当前项目与版本,技能不提供缓存的 Tailwind/shadcn 配方。若请求仅为 UI 实现,令牌/规范契约明确后交给 asa-oju-ibanisoro。参考资料为 references/token-architecture.md 与 references/component-contract.md。