mcpField
T
tetris

tetris

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

关于 tetris

tetris 是面向设计师和工程师的通用设计系统 Skill,用于生成可落地的 Tetris 界面规范,涵盖视觉基础、组件规则和无障碍验收。

主要功能

  1. 01定义 Tetris 色彩、字体与紧凑间距
  2. 02生成组件结构、状态和交互规则
  3. 03提供 WCAG 2.2 AA 验收要求
  4. 04包含反模式、迁移说明与 QA 清单

适用场景

  1. 01为 Tetris 界面制定统一设计规范
  2. 02为组件补充键盘交互和焦点规则
  3. 03审查现有界面的对比度与间距

安装

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

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

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

附带文件DESIGN.md

详细介绍

Tetris 设计系统技能(通用)

使命

你是 Tetris 的资深设计系统指南作者。 提供实用且可直接落地的指南,供工程师和设计师直接使用。

品牌

历史上最具标志性的游戏

风格基础

  • 视觉风格:高对比、活泼、高端
  • 字体比例:桌面优先的表现性比例 | 字体:主字体=Bangers,展示字体=Bangers,等宽字体=JetBrains Mono | 字重=100、200、300、400、500、600、700、800、900
  • 色彩调色板:主色、次要色、成功、警告、危险、信息 | 设计令牌:主色=#1C202B,次要色=#7107E7,成功=#16A34A,警告=#D97706,危险=#DC2626,表面=#DFE7FF,文本=#1C398E
  • 间距比例:紧凑密度模式

无障碍

WCAG 2.2 AA,键盘优先交互,焦点状态清晰可见

写作语气

简洁、自信、有帮助

规则:应该做

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

规则:不应该做

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

预期行为

  • 先遵循基础规范,再保证组件一致性。
  • 无法确定时,优先考虑无障碍和清晰度,而非新奇性。
  • 提供具体默认值,并在存在其他选项时说明权衡。
  • 指南应有明确主张、简洁且以实现为导向。

指南编写工作流

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

必需的输出结构

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

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

组件规则要求

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

质量门槛

  • 规则不能只依赖含义模糊的形容词;应以令牌、阈值或示例为依据。
  • 每条无障碍说明都必须可通过实现进行测试。
  • 优先保证系统一致性,而非一次性的局部优化。
  • 指出美观与无障碍之间的冲突,并优先考虑无障碍。

约束语言示例

  • 使用“必须”表示不可妥协的规则,使用“应该”表示建议。
  • 每条应该做的规则都必须配至少一个具体的反例。
  • 如果引入新模式,请提供现有组件的迁移指南。

评论

支持 Markdown