Communitygithub.com

UI设计

在构建任何UI界面或组件(Web或移动端)前加载:布局、间距、字体、颜色、阴影、按钮、表单、卡片、图标、导航、图像、文案、动效、无障碍及空/错误状态。每条规则对应一个参考文件:仅读取任务涉及的主题。

UI设计 是什么?

该技能提供了一套完整的UI设计规则体系,源自《UI设计原则》(Michael Filipiuk,2021版),帮助AI代理在任何项目中构建一致、可用且可访问的界面。它包含一个全局规则文件和按主题(如排版、颜色、表单、按钮等)组织的多个引用文件,开发者只需读取与任务相关的文件即可。该技能强调以仓库现有的设计系统(如Tailwind配置、CSS变量、shadcn/MUI主题)优先,仅填充缺失的规则。同时,它设定了15条不可协商的规则,例如间距需遵循4pt或8pt标尺、正文字体为16-17px、触摸目标至少44×44、对比度需满足WCAG标准等。该技能适用于任何前端框架或平台(Web、iOS、Android),并提供了优先级策略(可用性>无障碍>一致性>简洁>外观)以处理规则冲突。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JuanEliasJabib02/ui-design-skill/tree/HEAD

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

UI设计:构建界面规则

这些规则提炼自《UI设计原则》(Michael Filipiuk,2021版)。本文件包含适用于每个屏幕的规则。references/(位于本文件旁)按主题分文件存放详细内容;仅读取任务涉及的主题文件。

无标签的规则来自原书。(WCAG) 表示书中未提及的无障碍标准。(convention) 表示填补空白的常见行业惯例。(derived) 表示使用原书方法计算出的值。原书中1pt = 1 CSS px = 1 iOS pt = 1 Android dp。

仓库设计系统优先

如果仓库已有token或主题(Tailwind配置、CSS变量、shadcn/MUI主题、components/ui/库),请使用它们。本技能仅补充未定义的内容。

  • 绝不在仓库自有token旁引入第二套token。
  • 重用现有组件,而非构建平行组件。
  • 当仓库本身违反了以下规则(例如对比度不合格、32px按钮),保留仓库的值并报告冲突。不要静默覆盖。

规则冲突时的优先级: 可用性 > 无障碍 > 一致性 > 简洁 > 外观。

快速路径

  1. 首先确定个性: 基于品牌和受众(references/personality-and-copy.md)选择俏皮、中性或严肃。勿用个人品味。
  2. Token先于屏幕: 从仓库或references/tokens.md获取颜色、字体和间距标尺。只使用这些值。
  3. 灰度优先: 先处理好层级、布局和间距,仅在需要的地方添加颜色。
  4. 组件包含所有状态(默认、悬停、按压、聚焦、禁用、错误、成功),且每个屏幕都包含所有状态(空态、加载态、错误态、404)。
  5. 在报告完成前: 针对构建的内容检查references/checklist.md。如果可以截图,请检查截图而非代码。

不可协商规则

  1. 间距必须来自标尺。 移动端使用4pt标尺,Web端使用8pt标尺。不允许出现5、13或22px的值。
  2. 正文字体大小为16-17px。 任何文字不得低于10px,建议12px以上。小字号上绝不能用Light字重。
  3. 使用一款字体, 默认为无衬线字体。大约使用5种字号。
  4. 绝不用#000000 表示文字或阴影。使用深色灰调如#1F1F1F。
  5. 使用一种主色, 仅用于必须突出的元素。如果所有内容都突出,则无突出。
  6. 对比度: 正文字体4.5:1,大文字和UI部件3:1 (WCAG)。
  7. 绝不要仅用颜色 传递含义。错误、成功消息和链接也应配图标、文字、字重或下划线。
  8. 每个点击或触摸目标至少44×44, 即使可见图标更小。
  9. 按钮高度为40-60px, 每组中只有一个主按钮。按钮成对出现时,主按钮放在右侧。标签精确说明操作结果。
  10. 输入框始终有可见标签。 占位符不能作为标签。使用单列表单并启用内联验证,绝不清空用户输入。
  11. 阴影柔和(大Y偏移、大模糊半径、5-10%不透明度),仅用于交互或抬升元素。
  12. 图标来自同一图标包, 风格一致,具有相同的描边宽度和圆角。不通用图标需配有标签。
  13. 动画提供反馈, 持续时间小于1000ms,并采用缓动(绝不用线性)。
  14. 不用Lorem Ipsum。 写真实、简洁、人性化的文案。错误信息说明如何解决问题。对话框明确对象和后果。
  15. 相同内容在跨屏中具有相同的外观和行为。 遵循平台模式。

读取哪个引用文件

任务涉及读取
新项目或主题、选择值tokens.md(间距、字体标尺、颜色角色、圆角、阴影、动效、起始CSS)
页面或屏幕布局、网格、间距、层级layout.md
文字样式、标题、段落typography.md
调色板、暗黑模式、阴影、渐变color-and-depth.md
按钮和行动号召buttons.md
表单、输入框、选择器、复选框、校验forms.md
卡片、列表项cards.md
图标icons.md
标签栏、顶部导航、侧边栏、链接navigation.md
照片、插图、空态和404艺术imagery.md
品牌感觉、按钮标签、对话框、错误、语气personality-and-copy.md
过渡、悬停、加载、反馈motion.md
对比度、替代文本、目标、说明文字accessibility.md
可重用组件、状态、空态/404屏幕、设计系统system-and-states.md
审查完成的屏幕checklist.md

所有路径均位于本技能的references/文件夹下。

相关技能