Communitygithub.com

UI/UX 设计

基于可用性和视觉设计标准(尼尔森启发式、UX 法则、重构 UI、用户中心设计、WCAG 2.2 AA 及 NN/g 等有证据支持的模式),设计、实现、审查和批评界面(Web 应用、SaaS B2B、仪表盘、表单、表格、移动端)。无论是否明确提到“UX”或“设计”,只要结果将由用户在屏幕上使用,都应用此技能。

UX 设计 是什么?

此 AI 技能旨在系统化地将经过验证的 UI/UX 设计原则(包括《用户中心设计》(Lowdermilk)、《UX 法则》(Yablonski)、《重构 UI》(Wathan & Schoger)、NN/g 研究、WCAG 2.2 AA 和 GOV.UK 等公共设计系统)应用于代码中的界面。它适用于任何涉及创建或修改用户界面的任务——从实现组件(React、Tailwind、CSS)到进行启发式评估、可访问性审核、设计表单和表格、编写微文案,甚至是在实施前转换功能请求。该技能严格遵循一个等级结构:项目特定的设计系统(CLAUDE.md、令牌)优先,其次是 WCAG 等硬性约束,然后是有数据支持的指南,最后是战术建议(如“重构 UI”)。在审查或创建设计时,它强行要求明确说明用户需求(“当[情况]发生时,[用户]想要[结果]以便[原因]”)、上下文(ISO 9241-11)以及所有必要的状态(加载、空、错误、成功)。任何违反硬性标准或“重构 UI”中描述的常见视觉陷阱(如间距、颜色、对比度、字体粗细)都将在审查中被标记出严重级别。该设计方法主张先以灰度构建功能层次,再应用颜色;使用令牌系统(避免使用任意值);并优先使用原生 HTML 而非自定义 ARIA。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JVISERASS/ui-ux-design/tree/main

在你喜欢的 AI 中提问

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

文档

UX 设计 是做什么的?

个人技能。用我自己的话提炼三本书(Lowdermilk 的《用户中心设计》;Yablonski 的《UX 法则》;Wathan 和 Schoger 的《重构 UI》)以及 NN/g、WCAG 2.2 和公共设计系统的内容。详细信息、来源以及未经验证的内容均标记并放在 references/ 目录下。本文档是需要时刻牢记于心的内容。

0. 优先级

当两条建议冲突时,优先级更高的获胜:

  1. 项目设计系统和指令(CLAUDE.md、令牌、原语、品牌指南)。如果项目规定“圆角为 0 且无阴影”,则不提议使用阴影,即使《重构 UI》推荐它们:使用系统允许的方法(边框、背景、间距)来实现深度。在发明任何新令牌之前,先阅读现有令牌和组件。
  2. 硬性规则:WCAG 2.2 AA 可访问性,且不误导用户。如果项目系统违反对比度或焦点要求,需指出违反的 WCAG 标准,并在系统内提供替代方案。
  3. 证据:有数据支持的研究和指南(NN/g、Baymard、GOV.UK、ISO 标准)。
  4. 工艺:来自《重构 UI》及类似来源的战术建议。这些通常是好的建议,但并非法则。

始终说明建议属于哪个层级:“WCAG 1.4.3(强制)”与“通常这样更好”的权重完全不同。

1. 在动手设计之前:需求

需求通常以解决方案的形式出现(“添加 CSV 导出”、“在这里放一个按钮”)。其背后是一个需求,而直接设计该文字解决方案通常会导致更大的表面积和更差的结果。因此,在设计之前:

  • 重新表述需求为:当[情况]发生时,[用户]想要[结果]以便[原因]。如果无法填写情况和原因,请询问或明确说明假设。
  • 使用情境(ISO 9241-11):谁、什么任务、地点以及使用什么设备(户外阳光下的手机、双屏桌面、专家日常使用或一年一次)。“可用”是抽象的:它总是针对某个人、某个任务、在某个情境下而言的。
  • 寻找当前的变通方案(Excel、WhatsApp、纸质记录):这是所需功能的最佳规格说明。
  • 提供至少一个替代方案,该方案能用更少的界面解决相同的需求(如果存在)。
  • 先走幸福路径,然后立即处理各状态:加载、空(首次/因筛选/无权限)、错误、成功、部分成功。没有状态的屏幕不算设计完成。

关于面试、可用性测试、用户数量、指标和 SUS 的信息 → references/centrado-en-usuario.md。

2. 结构与交互(对可用性影响最大)

尼尔森启发式,作为快速检查清单:

  1. 系统状态可见:系统应告知用户正在发生的事情(保存中、已保存、加载中、错误)。
  2. 使用用户的语言,而非数据模型的语言。
  3. 用户控制和自由:撤销、取消、返回。
  4. 一致性和标准:相同事物外观和行为一致,并遵循平台惯例。
  5. 错误预防:约束、良好的默认值、接受多种格式。
  6. 识别而非回忆。
  7. 灵活高效的使用:为专家提供快捷方式,同时不妨碍新手。
  8. 极简主义:每个元素都在与其同类竞争。
  9. 帮助用户识别、诊断并恢复错误:错误信息应说明发生了什么以及如何修复。
  10. 帮助和文档:情境相关的帮助。

最常用的 UX 法则及其局限:

法则何时应用注意什么
雅各布使用常规模式;在价值上创新,而非导航行业惯例(ERP、CAD)比通用 Web 惯例更重要
菲茨目标大且靠近注意力点;提交按钮放在最后一个字段旁边“无限”角落仅适用于鼠标,不适用于触屏
希克在时间紧迫时减少选项;突出推荐项;渐进式揭示仅适用于从已知选项中做选择;对于搜索,关键是组织方式(顺序、分组、搜索)
米勒/工作记忆分组(组块);让系统替用户记忆“7±2” 不限制菜单数量:可见内容不占用内存。实际容量约为 ~4 个区块(Cowan)
泰斯勒让系统吸收复杂性(默认值、自动补全、计算)隐藏并非简化:只是转移了复杂性
波斯特尔接受各种格式并标准化接受并不意味着无声地猜测:如果存在歧义,应显示解释或询问
峰终精心设计价值最高点和结束时刻;注意负面峰值—
冯·雷斯托夫每个区域只突出一个元素如果所有元素都突出,则没有元素突出,且突出元素可能看起来像广告
响应时间<0.1 秒感觉即时;~1 秒轻反馈;2–10 秒骨架屏或旋转器;>10 秒显示百分比 + 取消按钮1982 年原始报告中未出现“400 毫秒”的 Doherty 阈值;使用 Nielsen 的 0.1/1/10 秒规则
目标梯度在长流程中显示诚实可见的进度虚假的进度是欺骗性模式

所有 30 条法则、按情境(表单、引导、结账、表格、移动等)的映射以及误用示例 → references/leyes-ux.md。

有证据支持的模式(详情和来源 → references/patrones.md):

  • 表单:标签在上方且始终可见(切勿将占位符用作标签);单列;正确的 autocomplete 和 inputmode;不要将电话号码、日期或 IBAN 拆分成多个字段;在离开字段时或提交时验证,并在错误被修正后立即移除错误信息(“早奖励,晚惩罚”);错误信息放在字段旁边,说明发生了什么以及如何修复,并使用标签中的措辞;始终保留已输入的内容。
  • 按钮:动词 + 宾语(“保存发票”,而非“确定”);每个视图只有一个主要按钮;避免禁用按钮而不解释原因(最好允许点击并解释);避免重复提交。
  • 破坏性操作:撤销优于确认;仅对不可逆操作进行确认,并说明将丢失什么,按钮使用明确操作(“删除 3 张发票”/“保留”),而非是/否。
  • 空状态:说明是空的(而非正在加载),将出现什么内容,以及开始操作的按钮;在没有内容时隐藏筛选和排序。
  • 表格:第一列使用可读标识符;数字右对齐并使用 tabular-nums 且小数位数统一;固定表头;筛选条件可见,且当前激活的筛选条件一目了然;行操作按钮始终可见,而非仅在悬停时显示;提供拖拽的替代方案。移动端:使用卡片浏览记录,使用第一列固定的表格进行比较。
  • 仪表盘:一个任务目的;每个数字附带比较基准、单位和时间周期;条形图和折线图优于饼图或速度表;颜色有意义,且绝不仅仅是唯一线索。
  • 导航:桌面端可见(汉堡菜单会降低可发现性);移动端底部栏包含 3–5 个目的地,附带图标和文字;常用功能放在可及区域,关键功能不要放在角落。
  • 微文案:最重要的内容放在前两个词;减少一半文字;使用可扫读的副标题;短句,主动语态;不使用“请”、“哎呀”或“无效”。

3. 视觉设计(《重构 UI》精髓)

带具体值和 CSS/Tailwind 的详细信息 → references/diseno-visual.md(§11 是速查表)。

  • 从功能而非布局开始,并且 先保持灰度:如果在灰度下层级不清晰,颜色也无法修复。颜色放在最后。
  • 系统优于随意值:间距、字号、颜色、阴影和圆角的固定刻度,并从刻度中选择。在代码中:使用令牌;没有正当理由不使用任意值(如 p-[13px])。
  • 层次通过粗细和颜色来体现,而非大小:2–3 种文字色调(主要、次要、三级)和 2 种字重(常规和半粗/粗);无低于 400 的字重。突出某物通常意味着调暗与之竞争的元素。
  • 标签是最后的手段:使用不言自明的格式(“库存 12 件”优于“库存:12”);如果需要标签,应使其比值的视觉权重更轻。章节标题通常可以用作小标签:视觉层次不必遵循 h1…h6 的 HTML 层次。
  • 间距:从足够的空间开始,然后削减;非线性比例(4、8、12、16、24、32、48、64、96…),其中每一步不小于上一步的约 25%;组之间比组内更多空间(标签紧邻其字段)。
  • 宽度:不要拉伸到全屏;组件设置 max-width;段落 45–75 字符;侧边栏固定宽度,内容区域自适应。
  • 文字:手动调整的排版比例(12/14/16/18/20/24/30/36/48…),单位 px 或 rem,绝不使用 em;正文行高约 1.5,标题约 1–1.25;大标题字符间距稍紧,大写字母字符间距稍宽;混合字号时基线对齐;文本居中仅在 2–3 行内使用。
  • 颜色:8–10 种灰色(略带色调)和每种颜色 5–10 个色调(100–900),预先定义,最好使用 OKLCH(感知亮度均匀);极端颜色色度更高;绝不在彩色背景上使用灰色文字(使用相同颜色的色调);徽章使用反转对比度(浅色略有色调的背景,深色同色调文字);颜色绝不应作为唯一信号。
  • 按钮按重要性而非语义分类:主要(实心)、次要(轮廓或浅色背景)、三级(类似链接)。破坏性操作仅在其是主要操作时(如确认对话框的最终按钮)才设为红色且显眼。
  • 深度(如果系统支持):光线来自上方;约 5 种双层阴影;减少边框(用间距、背景或阴影分隔);使用强调色边框增添色彩。无阴影时:使用背景差异和细边框。
  • 图片:图标不缩放(将其放入带背景的形状中);用户上传的图片放入固定容器,使用 object-fit: cover;图片上的文字需要叠加层以确保对比度。
  • 深色模式:重新分配语义令牌,而非简单反转;表面亮度随高度增加;强调色降低饱和度。
  • 数字:在需要比较或实时更新的所有内容上使用 font-variant-numeric: tabular-nums。

4. 可访问性:不可妥协的底线

目标为 WCAG 2.2 AA(同时也是 EN 301 549 V4.1.1 在欧盟的要求)。包含所有 55 个 A/AA 标准、ARIA、模态框、aria-live 区域以及测试方案的完整检查表 → references/accesibilidad.md。

  • 使用原生 HTML 而非 ARIA(button、a href、label、fieldset、dialog);零个可点击的 div。
  • 对比度:文本 ≥ 4.5:1;大文本(≥ 24 px,或 ≥ 18.66 px 加粗)、输入边框、信息性图标和焦点 ≥ 3:1。使用 WCAG 2.x 公式测量,而非 APCA。
  • 完整键盘支持;可见焦点(:focus-visible)不被固定页眉或侧边栏遮挡(scroll-padding);模态框焦点锁定,Esc 键关闭,关闭后焦点返回。
  • 目标大小至少 24×24 px CSS 作为法律底线;触控设计目标为 44–48 px。
  • 所有拖拽操作都有非拖拽替代方案(看板、排序、滑块)。
  • 错误文本显示在字段旁边,使用 aria-invalid 和 aria-describedby;不能仅使用颜色表示错误。
  • 异步状态使用 role="status"(紧急情况使用 alert)宣布,且区域已预先渲染。
  • 登录:允许粘贴;autocomplete 使用 username、current-password 和 one-time-code;避免认知测试。
  • 在同一流程中不重复询问已输入的信息。
  • 页面可缩放至 320 px 宽度而无需横向滚动(数据表格除外);200% 缩放;prefers-reduced-motion。
  • axe 报告为绿色并不代表完全可访问:在 GOV.UK 研究中,最好的工具发现了约 41% 的障碍(所有工具一起约 71%),Deque 估计 axe 检测到约 57% 的问题。还需要进行一轮完整的键盘测试和快速的屏幕阅读器测试。

5. 根据请求类型开展工作

在代码中实现或改进 UI

  1. 阅读项目的设计系统(令牌、原语、已实现的类似组件)并优先复用,而非创建新组件。
  2. 编写需求描述、使用情境和所有状态(§1)。
  3. 首先构建功能,保持灰度层次;然后使用令牌应用间距、排版和颜色。
  4. 覆盖所有状态:默认、悬停、焦点可见、激活、禁用(带原因)、加载、空、错误、成功。
  5. 检查:移动端宽度(320–380 px)和桌面端宽度、键盘导航、对比度以及长文本或极端数据(60 字符名称、7 位数字金额、0 行和 500 行列表)。如果浏览器可用,在真实屏幕上查看:截图能揭示代码未显示的问题。

审查屏幕、截图或 PR

应用 §2–§4 并返回:

  1. 摘要:2–3 行,说明什么有效以及最严重的问题。
  2. 发现:按严重性排序(Nielsen 量表:4 灾难性,发布前必须修复 · 3 重大 · 2 较小 · 1 美观)。每个发现项包括:位置、违反的原则(启发式、法则或 WCAG 标准编号)、受影响的用户群体及影响方式、以及具体的修复建议(值、组件、文案),区分强制性和建议性修改。声明严重性是单一评估者的判断。
  3. 快速修复:最多 5 个,影响最大且工作量最小的改进。
  4. 开放性问题:只能通过数据或用户测试来解决的问题。

在替代方案之间做决策

根据主要任务和使用情境(§1)进行比较,而非凭个人喜好。如果差异取决于实际行为,应指出这一点并提出成本最低的验证测试(5 用户测试、A/B 测试、分析):references/centrado-en-usuario.md §5。

非代码设计(流程图或线框图)

交付内容:重新表述的需求、幸福路径(含所有状态)的流程图、每个屏幕的结构(每个设计决策背后有一个原则支持)、以及需要与用户验证的事项。

6. 行为规则

  • 具体优于笼统:用“将次要文本从 Tailwind v3 的 gray-400 提升至 gray-600(对比度从 2.5:1 变为 7.6:1 在白色背景上;WCAG 1.4.3 要求 4.5:1)”替代“改进对比度”。
  • 每条建议附上一行理由,并指明其优先级层级(设计系统、WCAG、证据、工艺)。
  • 如果没有来源或者来源是推测,则声明未知:“尚未通过用户测试检验”优于错误地呈现为事实的建议。
  • “桌子上的尸体”:如果发现一个严重问题,即使不在原始请求范围内,也应报告。如果范围发生变化,声明这个决定。
  • 无法访问 ≠ 无法修复:始终提供一个在约束条件下可行的替代方案。
  • 如果用户界面是功能性的,不要痴迷于像素完美匹配:只要语义和视觉层次更强,偏离设计稿是可以接受的。
  • 在表述建议时,使用验证模式的措辞(§1):当[情况]发生时,[用户]想要[结果]以便[原因]。

相关技能