跳转到使用指南
Theming System作者 Owl-Listener

Theming System Skill.

让同一个组件库无需复制结构即可改变外观。

  • 设计系统
  • 主题化
来源审查 · Theming SystemSKILL.md
任务 设计系统 产出 • 带覆盖规则的三层令牌架构。 • 涵盖所需颜色、品牌或密度模式的主题矩阵。 • 组件覆盖范围,以及固定令牌与可主题化令牌的指导说明。 开始之前 实现时使用项目的令牌系统或平台上的等效方案;运行时切换功能必须构建并经过测试。
编辑摘要 · 已审查来源 2026-10-07 · 并非生成的示例

01 功能说明

通过令牌支持多种主题

一种分层主题架构,用于让共享组件适配不同品牌、颜色模式和密度变体。

基于来源的工作流程并非执行基准测试

工作方法

Theming System 将主题差异置于分层令牌架构中。原始调色板值传递给语义角色,后者再传递给组件作用域令牌。主题覆盖主要改变语义层,使相同组件可以服务于不同品牌或颜色模式。

来源指出,主题并不等同于简单地反转颜色。深色表面、层级、饱和度和图像变体都需要经过审慎处理。来源还将密度列为一个主题维度,因此该规范并非只适用于颜色。

预期交付物

  • 带覆盖规则的三层令牌架构。
  • 涵盖所需颜色、品牌或密度模式的主题矩阵。
  • 组件覆盖范围,以及固定令牌与可主题化令牌的指导说明。
查看示例简报

从简报到审查

  1. 01
    分离令牌层

    识别原始基础值、基于用途的别名和组件级引用。

  2. 02
    规划主题覆盖

    为每个所需主题更改语义角色,同时保持组件契约不变。

  3. 03
    检查整个组件库

    审查每个受支持主题中的每个组件,包括图像和操作系统偏好设置的行为。

02 适用场景

适用场景

实现时使用项目的令牌系统或平台上的等效方案;运行时切换功能必须构建并经过测试。

适合的场景

  • 多品牌产品适用于白标或子品牌界面必须共享一个组件库的情况。
  • 不止浅色与深色模式也为高对比度或密度变体提供结构。

需要核实的限制

  • 并非单一调色板练习仅选择一组颜色并不能建立可维护的主题架构。
  • 不会自动认证对比度每种实际的文本、表面和状态组合仍需测试。

请提供以下输入

  • 受支持的主题列出品牌、颜色模式、对比度模式和密度要求。
  • 现有令牌提供调色板、语义别名和组件引用。
  • 固定品牌元素明确在不同主题之间不得改变的资源或值。

03 关键决策

关键决策

  1. 在正确的层级进行覆盖

    语义别名可避免将品牌特定颜色散布在各个组件实现中。

  2. 资源也是主题的一部分

    图像和插图可能需要不同变体;仅更改 CSS 变量未必能让深色模式保持协调。

04 示例任务

尝试一份聚焦的简报

以下示例简报尚未经过测试。使用前请检查该技能的设置说明。

检查设置

使用仓库中记录的安装方式,并保留其中引用的所有配套文件。此条目介绍的是一种聚焦的设计方法,而非可执行应用程序。

上游源文件
https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/design-systems/skills/theming-system/SKILL.md

实现时使用项目的令牌系统或平台上的等效方案;运行时切换功能必须构建并经过测试。

从一项交付物开始

运行该技能前,请根据需要调整这份简报中的范围、来源材料和约束条件。

示例简报
将 theming-system 用于一个由两个品牌共享且同时支持浅色和深色模式的组件库。定义原始、语义和组件层,识别固定令牌,并展示主题覆盖的工作方式。纳入图像变体和按组件与主题划分的质量保证矩阵,不要假定仅反转颜色就足够。

检查结果

根据以下可观察标准检查实际输出。

  • 组件令牌通过已记录的语义角色解析。
  • 可主题化值与固定值有明确区分。
  • 测试矩阵包含每个受支持的主题。

OpenDesign 为编码智能体提供本地设计工作区。此条目并不表示该技能已捆绑提供,也不表示其中包含该技能所需的外部工具、凭据和软件依赖项。

05 来源与许可证

来源与许可证

本页面描述的是下方链接所指向的固定来源修订版本。上游行为和要求可能发生变化。

来源所有者
Owl-Listener
许可证
MIT
已审查的快照
2026-10-07 · 9a6930cf84a8
编辑来源摘要
一种分层主题架构,用于让共享组件适配不同品牌、颜色模式和密度变体。

由 OpenDesign 根据所链接来源撰写的原创摘要。仓库星标数只是带有时间属性的受欢迎程度指标,并不代表技能使用量或质量评分。

06 开始前的问题

开始前需要考虑的问题

主题应在哪一层覆盖令牌?

来源将主要覆盖置于原始值与组件特定令牌之间的语义层。

密度可以作为主题吗?

可以。来源除了颜色和品牌模式外,还包括舒适、紧凑和宽松三种密度。

它是否规定了唯一的实现工具?

它列出了 CSS 自定义属性、令牌文件、Figma 变量模式和运行时切换,并未强制要求使用某一种技术栈。

OpenDesign

为下一轮设计迭代留出空间。

将简报、来源材料和设计工作集中保存在本地工作区中。将该技能添加到工作流程前,请先检查其自身的设置说明。

上游源文件
https://github.com/Owl-Listener/designer-skills/blob/9a6930cf84a822eb458624bd11c61aac5bbdf224/design-systems/skills/theming-system/SKILL.md