SuperAPI AI 工具集

ryux-design-system

设计与创作

查看项目

更新于 10-20 17:13

技能介绍

RYUX 设计系统是一套用于 UI 交付的设计系统工作规范,属于 DESIGN SYSTEM · RX-2.0 的一部分,级别定义在 ryux-core 中。

用途 该技能用于在添加或修改 UI 组件、样式或设计令牌时提供约束性指导,帮助团队保持产品内的一致性,避免重复造轮子和组件漂移。

主要能力

  1. 先搜索再创建:在新建任何内容前,先检索现有组件、现有令牌(颜色、间距、圆角、字体、阴影)以及现有模式(相似界面如何解决同类问题)。如果现有组件适用则复用;接近适用则以变体扩展;只有存在真实语义或行为差异时才新建组件,并说明原因。
  2. 质量锁:跨产品保持间距、字体排印、颜色角色、术语、组件、交互模式与状态、响应式行为和视觉层级的一致性。
  3. 组件状态统一:同一组件在任何位置的外观与行为一致,其默认、悬停、聚焦、按下、禁用、加载和错误等状态只定义一次。
  4. 令牌优先:颜色、间距、圆角、阴影和字体使用令牌或变量,避免对系统已定义的内容硬编码一次性数值。
  5. 无系统项目的最小方案:若项目尚无设计系统,则定义当前界面所需的最小令牌集并一致使用,不引入项目未使用的组件库。

规则要点

  • RX-DS-01(必需,硬性门禁):创建前先搜索;不得为一个界面创建近乎重复的组件或模式,理由是重复会导致漂移、增加维护成本并破坏一致性。检查方式为 review。
  • RX-DS-02(必需,质量锁):遵循平台惯例和项目自身模式;同一组件在各处外观与行为一致,状态一次定义;不得在不同界面对相似组件做不同样式或连接。检查方式为 heuristic_eval H-04。
  • RX-DS-03(首选,质量锁):使用令牌或变量管理颜色、间距、圆角、阴影和字体;不得对系统已定义内容硬编码一次性值。检查方式为 review。

适用场景 适用于新增或变更组件、样式、令牌的设计与开发环节,以及需要对设计系统一致性进行审查的团队。

限制 硬性门禁始终适用:不得编造数字、人物、紧迫信息、业务规则或术语;不得将占位内容作为最终成品交付;不得缺失关键状态。关于参考应用如何保持组件一致的证据来自 RYUX 知识库;如未使用 ryux MCP,则需说明证据仅来自设计与标准。具体安装命令、集成方式与支持平台暂未提供。