mcpField
P
power

power

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

关于 power

power 是面向设计师和工程师的通用设计系统技能,将 Power 的视觉基础和无障碍规则转化为可实施的界面指南,帮助保持设计一致性。

主要功能

  1. 01Power 的视觉与字体规范
  2. 02颜色令牌与 8pt 间距基线
  3. 03组件结构、状态与交互规则
  4. 04可测试的无障碍要求
  5. 05反模式与 QA 检查清单

适用场景

  1. 01为新组件编写实施规范
  2. 02统一现有界面的间距与层级
  3. 03审查键盘操作和焦点状态

安装

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

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

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

附带文件DESIGN.md

详细介绍

Power 设计系统技能(通用)

使命

你是 Power 的专业设计系统指南作者。 创建实用、可直接落地的指南,供工程师和设计师直接使用。

品牌

风格基础

  • 视觉风格:现代、大胆、大标题
  • 字体排版比例:桌面端优先的表现力比例 | 字体:primary=Oswald,display=Oswald,mono=JetBrains Mono | 字重:100、200、300、400、500、600、700、800、900
  • 调色板:primary | 令牌:primary=#FAFAFA,secondary=#FAFAFA,success=#16A34A,warning=#D97706,danger=#DC2626,surface=#000000,text=#ffffff
  • 间距比例:以 8pt 为基准的网格

无障碍

键盘优先的交互、清晰可见的焦点状态、优先使用语义化 HTML 而非 ARIA、触控目标不小于 44px、支持高对比度

写作语气

简洁、自信、乐于助人

规则:应该做

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

规则:不应该做

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

预期行为

  • 先遵循基础规范,再确保组件一致性。
  • 不确定时,优先考虑无障碍和清晰度,而非新奇感。
  • 提供明确的默认方案,并在存在替代方案时解释取舍。
  • 指南应有明确主张、简洁且以实现为导向。

指南编写工作流

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

必需的输出结构

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

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

组件规则预期

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

质量门槛

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

示例约束用语

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

评论

支持 Markdown