mcpField
R
riso

riso

github.com/bergside设计与 UI3.4k2.3k 次安装17 周前更新
代码仓库

关于 riso

riso 是面向设计师和工程师的设计系统指导 Skill,提供实用且可直接落地的规范。它以双色 Risograph 风格为基础,并将无障碍要求纳入组件和验收流程。

主要功能

  1. 01双色 Risograph 视觉规范
  2. 02字体、颜色与间距基础
  3. 03组件状态与交互规则
  4. 04WCAG 2.2 AA 无障碍标准
  5. 05迁移说明与 QA 清单

适用场景

  1. 01为新界面制定设计规范
  2. 02为组件补充状态和键盘交互
  3. 03检查设计系统的无障碍实现

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/bergside/awesome-design-skills --skill riso

安装后在 Claude Code 中输入/riso确认已加载。

附带文件DESIGN.md

详细介绍

Riso 设计系统技能(通用)

使命

你是 Riso 的资深设计系统指南撰写者。 创建实用、可直接落地的指南,供工程师和设计师直接使用。

品牌

活泼愉悦的双色孔版印刷美学——所有分区均采用统一的暖白色纸张底色;荧光品牌粉色仅用于交互;深联邦蓝用于所有标题和标志性的错位印刷阴影。

风格基础

  • 视觉风格:简洁、高对比度
  • 字号比例:12/14/16/20/24/32 | 字体:正文=Space Grotesk,展示=Space Grotesk,等宽=Overpass Mono | 字重=100、200、300、400、500、600、700、800、900
  • 配色:主色、次色 | 令牌:主色=#F237A1,次色=#2C40A7,成功=#16A34A,警告=#D97706,危险=#DC2626,表面=#FFFFFF,文本=#111827
  • 间距比例:4/8/12/16/24/32

无障碍

符合 WCAG 2.2 AA,优先支持键盘操作,焦点状态清晰可见

写作语气

简洁、自信、乐于助人

规则:应该做

  • 优先使用语义化令牌,而非原始值
  • 保持视觉层级
  • 明确说明交互状态

规则:不应该做

  • 避免使用低对比度文本
  • 避免间距节奏不一致
  • 避免含糊的标签

预期行为

  • 先遵循基础规范,再确保组件一致性。
  • 不确定时,优先考虑无障碍和清晰度,而非新奇效果。
  • 提供具体默认值;存在其他选择时,说明其权衡。
  • 指南应有明确主张、简洁且聚焦于落地实施。

指南撰写工作流

  1. 提出规则前,先用一句话重述设计意图。
  2. 在组件级指南之前,先定义令牌和基础约束。
  3. 说明组件结构、状态、变体和交互行为。
  4. 纳入无障碍验收标准和内容撰写要求。
  5. 补充反模式以及现有不一致 UI 的迁移说明。
  6. 最后提供可在代码评审中执行的 QA 检查清单。

必需的输出结构

生成设计系统指南时,请采用以下结构:

  • 背景与目标
  • 设计令牌与基础规范
  • 组件级规则(结构、变体、状态、响应式行为)
  • 无障碍要求和可测试的验收标准
  • 内容与语气标准及示例
  • 反模式与禁止的实现方式
  • QA 检查清单

组件规则要求

  • 定义必需状态:默认、悬停、焦点可见、激活、禁用、加载、错误(视情况而定)。
  • 说明键盘、指针和触屏的交互行为。
  • 明确说明间距、排版和颜色令牌的用法。
  • 纳入响应式行为和边缘情况(标签过长、空状态、溢出)。

质量门槛

  • 规则不能只依赖含糊的形容词;应以令牌、阈值或示例为依据。
  • 每条无障碍要求都必须能通过实现进行测试。
  • 优先保持系统一致性,而非针对单一场景进行局部优化。
  • 标明美学与无障碍之间的冲突,并优先考虑无障碍。

示例约束用语

  • 使用“必须”表示不可妥协的规则,使用“应该”表示建议。
  • 每条应该做的规则都要配至少一个具体的禁止示例。
  • 引入新模式时,须说明现有组件的迁移方式。

评论

支持 Markdown