Adonis0123/adonis-skills / skills/design-system
design-system
VerifiedRun a shared multi-site design system where every product swaps only its interface accent color: analyze any website's theme colors and roles, wire a new site or plugin to the semantic tokens, and lint plugins for hard-coded colors, fallback values and unknown roles. Use when the user gives a URL and asks what its theme or palette is, asks to connect a site to the design system, add an accent theme, or check whether a plugin follows the theme contract. Skip one-off styling tweaks, logo or illustration work, and plugin-architecture refactors (code-plugin-architecture).
Design System
一套设计系统给多个站点用:底色、分层、功能色、字体、圆角共用,每个产品只换界面强调色。本 skill 管三件事:分析站点的主题色、接入新站点或新主题、检查插件是否守契约。色值本身不在这里,在设计系统目录的 tokens.json(格式见 references/token-format.md)。
先找到设计系统
按顺序找,找到就停:用户给的路径 → 当前仓库的 design-system/tokens.json → 仓库 AGENTS.md/CLAUDE.md 里写明的品牌仓库路径。都没有就问用户,不自己编一套色值。
找到后先跑一次检查,确认起点是好的:
python3 scripts/check_tokens.py <design-system>/tokens.json
1. 分析一个站点的主题色
用户给 URL,问它的主题色、配色做法,或想参考它时用。
先定分析对象。营销站(首页、定价页)和产品界面(登录后的应用)常常不同色:营销页可以用渐变、背景视频,产品界面只用一个强调色。先确认用户要的是哪一个,结论里写明实际分析的地址。
证据分级。按下面的顺序定结论,结论里每个色值标出它属于哪一级:
| 级别 | 来源 | 用法 |
|---|---|---|
| 界面实测 | 产品界面里实际渲染的按钮、焦点环、选中态、链接等元素的 getComputedStyle | 定结论 |
| 变量定义 | 产品自己命名的主题变量,例如 --<产品>-theme-accent-color、--primary | 说明产品定义了这个色;它是不是界面强调色,要看下一段的可见性检查 |
| 素材或第三方旁证 | 应用图标、插画、背景视频像素、CLI/终端配色、通用色板里的一档、第三方 DESIGN.md 合集 | 只做核对,不单独定结论 |
定义了不等于在用。变量名叫 accent 或 theme,界面也可能几乎不用它。对每个候选强调色,列出它实际出现在哪些可见元素上,以及平时能不能看到:只在键盘焦点环、偶发的提示圆点这类状态上出现的颜色,不能叫界面强调色。平时可见的按钮、选中态、链接、图标都只有黑白灰时,直说界面是黑白的,再单列一行“定义了但几乎不可见”的颜色和它出现的位置。
图标和插画常用渐变,取像素平均值得到的是界面里不存在的颜色;CLI 的终端配色要照顾终端可读性,通常取自通用色板,和网页界面不是一套。旁证与实测冲突时以实测为准,并在结论里写出冲突的两个值。
要登录才能看的界面。请用户先在浏览器里登录,再用宿主的浏览器工具连上这个已登录的页面实测。不替用户登录,不输入账号密码。看不到就把这部分标 UNVERIFIED,不拿营销页或图标的颜色代替。
-
用 dembrandt 抽取实际渲染的颜色(锁版本)。先直接跑;报缺浏览器时再跑
install-browser,它在本机已有浏览器或别的进程正在下载时会长时间无输出:npx -y dembrandt@0.39.2 <url> --shadcn --wcag --save-output npx -y dembrandt@0.39.2 install-browser # 只在上一条报缺浏览器时 -
dembrandt 只给“出现过哪些色”,
--dark-mode也常常读不出深色变量。按钮、当前项、选中态各用了哪个色要实测:用 Playwright(或宿主自带的浏览器工具)打开页面,waitUntil: "domcontentloaded"后再等几秒(营销站常有长连接,networkidle会超时),对这几类元素读getComputedStyle(background-color、color、border-color、box-shadow、font-weight),并读:root上的 CSS 变量。深色模式用colorScheme: "dark"的浏览器上下文再读一遍。- 页面上有好几种实心按钮时,全列出来:首屏面积最大、文案是主要行动(试用、注册、开始)的那个算主按钮,其余写成次要按钮。品牌色按钮不一定是主按钮。
- 外层元素读到
rgba(0, 0, 0, 0)时,颜色多半画在内层元素或::before/::after上,往里找,或读按钮用的 CSS 变量。 - 遇到人机验证(例如 Cloudflare 的 “Verify you are human”)不绕过:这一页只用 dembrandt 的结果,并写明没实测。
- 页面重定向到别的域名时,在结论里写明实际分析的是哪个地址。
- 网页本身黑白无彩色时直说;再去官方品牌资料、设计系统仓库或产品源码里找它的标志色,写明出处。
- 能找到一手品牌资料(官方 brand guidelines、设计系统仓库)就拿来核对强调色。
- 想找现成的 DESIGN.md 参考时,依次查
VoltAgent/official-design-md(品牌官方发布的一手资料)、VoltAgent/awesome-design-md、Meliwat/awesome-ios-design-md(iOS 应用)、bergside/awesome-design-skills。这些合集收录不全,值也可能过时,只算旁证;和实测冲突时以实测为准并注明。
-
输出一张表和 5 条以内的做法总结,回答这几个问题:
- 分析的是营销站还是产品界面,实际地址是哪个。
- 界面强调色是哪个(色值和来源变量名);它出现在哪些可见元素上,平时能不能看到,面积大还是只上“点”。界面是黑白的就直说,定义了但几乎不可见的颜色单列。
- 中性色偏冷、偏暖还是纯灰;分层靠线、靠亮度还是靠阴影。
- 主按钮文字白还是深,WCAG 对比度多少,是否达标。
- 选中态是实心块、淡彩底还是竖线;背景有没有染品牌色。
- 每个色值标“界面实测”“变量定义”或“素材或第三方旁证”,推断出来的另标“推断”。登录后才能看的页面没看到,就写
UNVERIFIED,不猜。
-
用户想借鉴时,把结论映射到
tokens.json的角色上,做成对比页面让用户看实物再定。不直接改tokens.json。
2. 接入一个新站点或新主题
新站点:
- 从
tokens.json生成 CSS 变量(设计系统自带脚本时用它的;否则按 token-format 里的规则解析引用),放进站点样式。 - 根元素加
data-accent="<主题>",深色模式加.dark。 - 组件里只写语义角色
var(--primary)等;把原有写死的颜色逐个换成最接近的角色,换不上就记下来问用户,不新造角色。 - 跑第 3 节的插件检查,再用真实页面看浅色、深色各一遍。
新主题(新的界面强调色):在 themes 里加一项:12 阶色阶(浅、深各一套)、solid、solid-foreground,solid 按下面的按钮规则定。跑 check_tokens.py,全部通过才算加完。
按钮规则:
- 颜色:保留主题色相,OKLCH chroma 拉到色域上限,再调亮度。白字在浅色模式约 4:1、深色模式约 3:1,所以
solid通常写成{ "light": …, "dark": … }。 - 字:白色,字重 500,不用 600。
- 形状:主按钮用胶囊圆角(
radius.pill);次按钮用黑白(浅色黑底白字,深色白底黑字)。 - 对比度:主按钮白字只要求 ≥ 3.0,低于 WCAG AA 的 4.5,是有意取舍:字节 Arco、Semi 和即梦的实心按钮都是饱和色配白字,实测约 3。
check_tokens.py按 3.0 检查这一对。 - 否掉的做法:原色配近黑字(不好看);把原色加深到 4.5 再配白字(发灰,不像原来的颜色);原色配同色相深字(不自然)。
- 产品本身是黑白的,就照实用黑白按钮,深浅模式反相。
- 拿不准时做浅深两种模式的样本,给用户看实物再定。
3. 检查插件是否守契约
插件只用语义角色:不写死色值,var() 不带后备色,不引用设计系统里没有的角色。缺变量就该显眼地坏掉,好让人发现没接上主题。
python3 scripts/lint_plugin.py <插件目录> --tokens <design-system>/tokens.json
脚本逐条报 文件:行 — 问题 — 改法,有问题时退出 1。故意保留的色值(例如品牌 logo 的固定色)在同一行写 design-system-ignore 并说明原因。脚本只是定位候选:logo、插画、截图里的颜色不算违规,逐条判断后再改。
插件的注册、加载结构要改时,交给 code-plugin-architecture;本 skill 只管颜色和主题契约。
交付
- 分析:表格加做法总结,写明分析对象,每个色值标证据级别。
- 接入:改了哪些文件、
check_tokens.py和lint_plugin.py的结果、浅深两种模式的页面验证。没看页面就写UNVERIFIED。 - 检查:问题清单和改法;用户要求时再动手修。
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation). | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults. | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |
| mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK). | Stars: 197k | Updated | Claude CodeCodex | Verified | Install |