Communitygithub.com

视觉设计

用于构建或修改设计系统,例如设计令牌、色彩调色板、对比度、字体、字号比例、间距比例、深色模式、动效令牌或组件状态规范。不用于布局或评审特定页面或重新设计;请使用 `designer`。不用于生成图像;请使用 `artist`。

视觉设计 是什么?

这是一个AI代理视觉设计技能,专注于构建和维护底层设计系统——包括色彩、排版、间距、形状、深度和动效的令牌,以及基于这些令牌构建的组件规范。它强调在创建任何令牌之前先用文字阐明设计方向,并严格遵循组件引用语义令牌而非原始值的规则。该技能支持跨平台设计系统(如Claude Code、Cursor、Codex等),通过提供色彩对比度检查、模块化排版、间距比例、动效设计、深色模式映射和组件状态清单等详细指南,帮助开发者建立一致且可扩展的设计语言,避免常见陷阱并确保可访问性。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/heliacon/claude-skills/tree/HEAD/skills/visual-design

在你喜欢的 AI 中提问

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

文档

视觉设计 是做什么的?

每个屏幕之下的系统:色彩、排版、间距、形状、深度和动效的令牌,以及基于它们构建的组件规范。designer 技能将该系统应用于实际页面。一次构建系统;让页面充分使用它。

最关键的规则

  1. 在任何令牌之前,先用文字阐明设计方向。 三到四句话:为谁设计,应该给人什么感觉,绝对不能给人什么感觉,以及从主题中借鉴的一点什么东西。每个令牌决策都需对照该段落进行检查。
  2. 组件引用语义令牌,而非原始值。 使用 --color-text-primary,而不是 --grey-900。深色模式、主题化和品牌重塑随后只需重新映射,无需重写。
  3. 检查每个实际颜色对在两个主题中的对比度,对照下表。在白色背景上通过测试的调色板,在其自身的着色表面上可能失败。
  4. 默认值不是决策。 框架灰、所有元素使用Inter字体、每个盒子4px圆角:每个看起来还行,但放在一起就像其他所有产品。决定每个值或有意接受它。
  5. 每个组件规范列出所有状态:默认、悬停、聚焦、活跃、禁用、加载、错误以及适用时的已选状态。缺失的状态会在构建时被不一致地发明出来。
  6. 更少的值,一致使用。 一个包含6步并处处使用的比例,优于一个包含14步却随意使用的比例。

何时不使用

  • 安排特定页面、选择折叠线以上的内容、评审屏幕或进行重新设计:使用 designer。
  • 生成插图、图标、英雄图片或品牌标志:使用 artist。
  • 图表和数据可视化调色板:查看 frontend 技能的 references/charts.md。分类图表颜色有品牌调色板所不具备的约束。
  • 在框架中实现令牌:使用 frontend。

构建顺序

每一层依赖于前一层:

  1. 方向段落。
  2. 色彩:原始值,然后语义令牌。
  3. 排版:字体,然后比例和角色。
  4. 间距比例和网格。
  5. 圆角、边框和高度。
  6. 动效令牌。
  7. 组件令牌和组件规范。

色彩

结构:

原始值(原始值,每个色相一条梯度,例如 50, 100 ... 900, 950):
  --blue-600: oklch(0.55 0.17 255)

语义令牌(引用原始值,按职责命名):
  --color-bg, --color-surface, --color-surface-raised
  --color-text, --color-text-muted, --color-text-on-accent
  --color-accent, --color-accent-hover
  --color-border, --color-focus-ring
  --color-danger, --color-success, --color-warning(每个都带有文本安全的变体)

区分经过深思熟虑的调色板与默认调色板的规则:

  • 在OKLCH空间中构建梯度。 亮度在各色相之间感知均匀,因此600蓝色和600绿色具有相同的视觉重量。HSL亮度会误导。
  • 为中性色着色。 纯灰色和纯黑色或白色看起来缺乏归属感。添加少量色度(约0.005至0.015)偏向品牌色相。
  • 彩色表面上的文本 使用该表面色相的深色色阶,而非中性灰。灰色在彩色上看起来褪色。
  • 选择一个承诺水平并坚持执行:克制(中性底色,一种强调色)、承诺(品牌色相无处不在)、全调色板、或浸入(品牌色相作为底色)。一半的承诺读作优柔寡断。
  • 决不让颜色单独传达含义。 将其与图标、标签或图案配对。
  • 注意当前的习惯反应。 暖奶油色页面搭配衬线展示字体和陶土色强调色,或近黑色搭配一种酸性强调色,是当没有做出决策时生成的设计会本能地采用的方案。仅在方向段落要求时才使用它们。

对比度 (WCAG 2.2)

配对AAAAA
正文文本(小于大号尺寸)4.5:17:1
大号文本:24px 常规,或约 18.7px 粗体及以上3:14.5:1
UI 组件边界、图标、焦点指示器、传达含义的图表标记3:1无
  • 向用户传达任何信息的占位符文本属于文本:4.5:1。
  • 禁用控件豁免,但用户仍必须能看见该控件存在。
  • 测量计算后的颜色,包括透明度与叠加效果。在着色卡片上的60%不透明度标签是一种新颜色。

排版

  • 根据内容基调选择字体,而非凭习惯。三种角色:一种有特色的展示字体,谨慎使用;一种舒适的正文字体;一种实用字体用于标签、说明和数据(表格中的数字使用表格数字)。
  • 配对时要有明显对比(衬线配无衬线,几何配人文主义)或使用同一家族的不同字重。两种相似但不完全相同的字体读起来像是错误。
  • 模块化比例。 选择一个比例:1.2用于密集的产品UI,1.25至1.333用于内容和营销。命名角色,而非尺寸:display、h1 到 h4、body-lg、body、body-sm、label、caption。
  • 行长 正文文本60到75个字符(max-width: 70ch)。
  • 展示字体 使用更紧的字间距(约 -0.02em 到 -0.04em)和尺寸上限(通过 clamp() 大约6rem)。更大的尺寸很少读起来像是故意的。
  • 标题使用 text-wrap: balance,正文使用 text-wrap: pretty。
  • 行高:正文约1.5,展示字体1.1到1.25。

间距、形状、深度

  • 间距比例 基于4或8的基数:例如 4, 8, 12, 16, 24, 32, 48, 64。组件使用令牌,从不使用原始像素值。
  • 圆角:两到三个值,并辅以规则说明何时应用于何处。嵌套圆角:内圆角等于外圆角减去它们之间的内边距。
  • 高度:三到四个级别,每个与一个职责绑定(静态卡片、下拉菜单、模态框)。在深色主题中,使用更亮的表面而非更重的阴影来提升高度。

动效

  • 令牌:持续时长(例如 120ms, 200ms, 320ms)和两到三条缓动曲线(一条用于进入,一条更陡峭的用于退出)。元素重复使用它们;没有人选择每个元素的值。
  • 动效解释变化:某物从何而来,什么做出了响应。仅为装饰的动效看起来像是生成的。
  • 一次精心编排的瞬间胜过所有东西同时淡入。
  • 尊重 prefers-reduced-motion: reduce:移除移动和长过渡,保留透明度变化。
  • 悬停时不要缩放图片。为容器添加动画(阴影、边框、背景)。

深色模式

  • 深色主题是语义令牌的重新映射,绝不是反转。使用深灰色作为底色,而非纯黑色,并降低会发光强调色的色度。
  • 在深色主题中重新检查每个对比度对。
  • 防止错误主题闪烁:在文档头部,首次绘制之前的一个小型内联脚本中决定主题。

在实现深色模式的主题切换、持久性或图像时,请阅读 references/dark-mode.md。

组件规范

在编写组件规范之前,请阅读 references/component-spec.md。它包含模板和状态清单。

常见陷阱

  • 11个色阶命名为100到900。 那是9个步骤。命名梯度时,让数量与名称一致(50, 100 ... 900, 950 给出了11个)。
  • “大号文本”指18点,而不是18像素。 18px常规正文文本需要4.5:1,而不是3:1。大号文本阈值是24px常规或约18.7px粗体。
  • 组件中的原始令牌。 有效直到第一个主题。然后每个组件都需要编辑。
  • 在模型上检查对比度,而不是在构建产物上。 透明度、叠加和抗锯齿会改变实际颜色。测量渲染后的像素或计算后的样式。
  • 一次全局调整来解决局部问题。 变暗整个调色板来挽救一个失败的配对会改变所有其他配对。修复该配对的令牌。
  • 没人使用的令牌,或没人令牌化的原始值。 都说明系统和构建已脱节。在构建产物中搜索原始十六进制和像素值。
  • 为一个标题加载新字体。 每种字体都耗费加载时间。使用系统已加载的字体。

验证

  • 已编写方向段落,并且每个令牌系列都可追溯至该段落。
  • 每个文本和UI配对在浅色和深色模式下均通过AA标准,并在构建好的页面上测量。
  • 组件仅使用语义令牌:搜索显示组件代码中没有原始颜色或间距值。
  • 每个组件规范列出其所有状态。
  • 已测试减少动效设置:无移动效果保留。
  • 在硬刷新且系统设置相反的情况下,主题切换无闪烁。

Individual skills in this repo

This repo contains 7 individual skills — each has its own dedicated page.

api-design

Use when designing or changing an HTTP API contract, adding or editing a route, endpoint or webhook, writing an OpenAPI spec, choosing error, pagination or versioning shapes. Also when asking "is this a breaking change". Not for server internals such as jobs, retries or rate-limit storage; use `backend-patterns`.

artist

Use when making or directing visual assets such as illustrations, hero images, icons, logos, brand marks, textures or diagrams, or writing prompts for an image-generation model. Covers art direction, reference boards and critique against a brief. Not for page layout; use `designer`. Not for palettes and tokens; use `visual-design`.

copywriter

Use when writing, rewriting or reviewing words a customer reads, such as landing or marketing pages, headlines, taglines, calls to action, pricing pages, product descriptions, onboarding text, button labels, error messages and empty states. Not for long-form docs or articles; use `docs`. Not for positioning strategy; use `marketing`.

designer

Use when asked to critique, redesign or review the layout and hierarchy of a page, screen, landing page or dashboard (hero, CTAs, card grids, testimonials), or when a design \"looks off\", \"looks generic\" or \"looks AI-made\". Use it for any layout feedback, even if the word design is not used. Not for tokens, palettes or type scales; use `visual-design`. Not for images; use `artist`.

frontend

Use when building, reviewing or fixing browser UI, such as pages, components, forms, client state, charts, print or PDF views, accessibility or web performance (Core Web Vitals, bundle size, slow renders). Not for visual direction, layout critique or brand (use `designer` or `visual-design`). Not for native or React Native apps (use `mobile`).

game-design

Use when designing or reviewing how a game plays: core loop, mechanics, game feel and juice, difficulty curve, progression, economy and balance, tutorials, HUD and menus or a game design document (GDD) and playtest plan. Not for engine code or rendering (use `frontend`) or for non-game product UX (use `ux-research`).

ux-research

Use when planning or synthesising user research (interviews, usability tests, surveys), mapping a journey or job to be done, specifying an interaction's states, or running a heuristic review of a flow. Not for menus, labels, taxonomy or site structure; use `information-architecture`. Not for visual polish; use `designer`.

相关技能