ui-ux-pro-max-skill 设计技能路由指南：八个子技能如何选型、路由与协同

2026-09-04 20:40:46作者：晏闻田Solitary

本文以 ui-ux-pro-max-skill 仓库中的设计路由指南（design-routing.md）为核心，完整解析该 AI 设计技能体系的子技能选型逻辑：如何按任务类型和自然语言问题将设计需求路由到正确的子技能，如何组合 brand、design-system、ui-styling 等多技能工作流，以及配套的快速命令与依赖链。读完后你可以直接按此指南为 Logo 设计、设计令牌、UI 组件、CIP 物料、演示文稿、Banner 和图标等具体任务选择技能、执行命令并验证结果。

技能全景：八个子技能的定位与资源规模

路由文档开篇给出了一张子技能总览表，明确了每个子技能的用途和配套资源（SKILL.md 主文件 + references 参考文档 + scripts 脚本）。以下表格完整继承原文档，并补充了各技能在仓库中的实际位置：

技能	用途	关键文件
brand	品牌识别、品牌语音、资产管理	SKILL.md + 10 个 references + 3 个脚本
design-system	令牌架构、组件规格	SKILL.md + 7 个 references + 2 个脚本
ui-styling	组件实现	SKILL.md + 7 个 references + 2 个脚本
logo-design	AI Logo 生成（55 种风格、30 个色板）	SKILL.md + 4 个 references + 2 个脚本
cip-design	企业识别系统（Corporate Identity Program，50 项交付物）	SKILL.md + 3 个 references + 3 个脚本
slides	基于 Chart.js 的 HTML 演示文稿	SKILL.md + 4 个 references
banner-design	社交、广告、网页、印刷横幅（22 种风格）	SKILL.md + 1 个 reference
icon-design	SVG 图标生成（15 种风格，Gemini 3.1 Pro）	SKILL.md + 1 个 reference + 1 个脚本

从仓库结构看，这八个能力分属两类载体：

外部技能（External skill）：brand、design-system、ui-styling 是独立技能目录，分别位于 brand/SKILL.md、design-system/SKILL.md、ui-styling/SKILL.md，拥有完整的 scripts、references 和 templates。
内置子技能（Built-in）：logo、CIP、slides、banner、icon 集成在 design 技能内部，design/SKILL.md 的 "Sub-skill Routing" 表格将它们标注为 "Built-in"，各自对应 references 下的专题文档（如 logo-design.md、cip-design.md、icon-design.md）和 scripts 下的 Python 脚本。

路由文档中引用的数据规模与仓库数据文件可以逐一核对：

55 种 Logo 风格：design/data/logo/styles.csv 含 56 行（1 行表头 + 55 条风格记录），字段包括风格名、分类、关键词、主色、辅助色、字体、适用/回避场景、复杂度与年代；
30 个 Logo 色板：design/data/logo/colors.csv；
15 种图标风格：design/data/icon/styles.csv 含 outlined、filled、duotone、rounded、sharp 等 15 条记录，带描边宽度、填充、适用场景等字段；
CIP 交付物/风格/行业：design/data/cip/deliverables.csv 记录名片、信纸、导视、车辆、服装等交付物及其尺寸、文件格式、Logo 放置规则、排版注意事项。

按任务类型路由（Routing by Task Type）

路由文档的第一级路由维度是"任务类型"。下面按原文档的八个任务类别逐一展开，每个类别保留原文档列出的具体任务清单。

品牌识别任务 → brand

以下任务应路由到 brand 技能：

定义品牌色彩与字体（Define brand colors and typography）
制定 Logo 使用规范（Create logo usage guidelines）
建立品牌语音与语气（Establish brand voice and tone）
组织与校验资产（Organize and validate assets）
创建信息传达框架（Create messaging frameworks）
品牌一致性审计（Audit brand consistency）

brand 技能的 SKILL.md 与上表一一对应，其 "When to Use" 覆盖品牌语音、视觉识别、信息框架、一致性审计、资产组织、色彩管理与字体规范。该技能还提供 sync-brand-to-tokens.cjs 脚本，把 docs/brand-guidelines.md 作为单一事实源同步到 design-tokens.json 与 design-tokens.css——这正是后文"技能依赖链"中 brand 向下游供给颜色与字体的机制。

令牌系统任务 → design-system

以下任务应路由到 design-system 技能：

创建设计令牌 JSON（Create design tokens JSON）
生成 CSS 变量（Generate CSS variables）
定义组件规格（Define component specifications）
将令牌映射到 Tailwind 配置（Map tokens to Tailwind config）
校验代码中的令牌使用情况（Validate token usage in code）
记录状态与变体（Document state and variants）

design-system 技能的 references 目录提供了对应的七份参考文档：token-architecture.md、primitive-tokens.md、semantic-tokens.md、component-tokens.md、component-specs.md、states-and-variants.md、tailwind-integration.md，与路由文档列出的六类任务形成完整闭环。

实现任务 → ui-styling

以下任务应路由到 ui-styling 技能：

添加 shadcn/ui 组件（Add shadcn/ui components）
用 Tailwind 类做样式（Style with Tailwind classes）
实现深色模式（Implement dark mode）
创建响应式布局（Create responsive layouts）
构建可访问组件（Build accessible components）

ui-styling/SKILL.md 声明其职责正是"基于 Radix UI + Tailwind 的 shadcn/ui 组件、Tailwind 实用优先样式、画布式视觉设计"，覆盖对话框、下拉框、表单、表格等可访问组件、主题定制、深色模式与响应式布局，并配套 tailwind-customization.md、shadcn-components.md、shadcn-accessibility.md 等七份参考文档与 tailwind_config_gen.py、shadcn_add.py 两个脚本。

Logo 设计任务 → logo-design

用 AI 创建 Logo（Gemini Nano Banana）
检索 Logo 风格、色板、行业规范
生成设计简报（design brief）
探索 55+ 种风格（minimalist、vintage、luxury、geometric 等）

对应脚本位于 design/scripts/logo/：search.py 提供 --design-brief 简报生成与 --domain style|color|industry 三域检索，generate.py 支持 --brand、--style、--industry、--prompt、--provider（Gemini 默认，Atlas Cloud 显式可选）等参数。logo-design.md 将风格细分为 General（Minimalist、Wordmark、Lettermark、Pictorial Mark、Abstract Mark、Mascot、Emblem、Combination Mark）、Aesthetic（Vintage/Retro、Art Deco、Luxury、Playful 等）、Modern（Gradient、Flat、3D/Isometric、Geometric 等）、Clever（Negative Space、Monoline 等）四大类，并给出行业默认值（如 Tech → Minimalist + 蓝紫色渐变 + 几何无衬线体）。

企业识别系统任务 → cip-design

生成 CIP 交付物（名片、信纸、导视、车辆、服装等）
创建带行业/风格分析的 CIP 简报
生成带 Logo 或不带 Logo 的样机（Gemini Flash/Pro）
从 CIP 样机渲染 HTML 演示

CIP 子技能位于 design/scripts/cip/：search.py 支持 --cip-brief 与 --domain deliverable|style|industry|mockup 检索；generate.py 支持 --logo、--deliverable、--industry、--set（全套交付物）、--model pro（4K 文字渲染）等参数；render-html.py 把 CIP 样机图片渲染为 HTML 演示。模型可选 flash（默认，gemini-2.5-flash-image）或 pro（gemini-3-pro-image-preview）。若尚无 Logo，design/SKILL.md 的提示是先走 Logo Design 流程再进入 CIP。

演示文稿任务 → slides

创建战略性 HTML 演示文稿
用 Chart.js 做数据可视化
将文案公式应用到幻灯片内容
使用版式模式与设计令牌

slides 为独立技能目录 slides/SKILL.md，其 references 包含 create.md、layout-patterns.md、html-template.md、copywriting-formulas.md、slide-strategies.md，对应路由文档列出的四类任务。

Banner 设计任务 → banner-design

为社交媒体设计横幅（Facebook、Twitter、LinkedIn、YouTube、Instagram）
创建广告横幅（Google Ads、Meta Ads）
网站 Hero 横幅与页眉
印刷横幅与封面
22 种艺术指导风格（minimalist、bold typography、gradient、glassmorphism 等）

Banner 的完整尺寸与风格清单见 banner-sizes-and-styles.md，design/SKILL.md 给出快速尺寸参考（如 Facebook 封面 820×312、YouTube 频道艺术 2560×1440、Google Ads 中矩形 300×250）与设计规则（安全区 70-80%、每横幅单一 CTA、最多 2 种字体、广告文字占比低于 20%、印刷 300 DPI/CMYK/3-5mm 出血）。

图标设计任务 → icon-design

用 AI 生成 SVG 图标（Gemini 3.1 Pro Preview）
批量生成多风格图标变体
多尺寸导出（16px、24px、32px、48px）
15 种风格：outlined、filled、duotone、rounded、sharp、gradient 等
12 个类别：navigation、action、communication、media、commerce、data 等

icon-design.md 说明模型 gemini-3.1-pro-preview 以纯文本输出 SVG（SVG 即 XML 文本），因此不需要图像生成 API；脚本 icon/generate.py 支持 --prompt、--style、--color、--batch（批量变体）、--sizes（多尺寸导出）、--output-dir 等参数。

按问题类型路由（Routing by Question Type）

路由文档的第二级路由维度是"用户自然语言问题"。当需求以问句形式出现时，按下表直接映射到技能，该表完整继承自原文档：

问题	路由到
"这个颜色应该用什么？"（What color should this be?）	brand
"我如何为 X 创建令牌？"（How do I create a token for X?）	design-system
"我如何构建一个按钮组件？"（How do I build a button component?）	ui-styling
"这符合品牌吗？"（Is this on-brand?）	brand
"这里该用 CSS 变量吗？"（Should I use a CSS variable here?）	design-system
"我如何加深色模式？"（How do I add dark mode?）	ui-styling
"给我的品牌做个 Logo"（Create a logo for my brand）	logo-design
"生成名片样机"（Generate business card mockups）	cip-design
"做个融资 PPT"（Create a pitch deck）	slides
"设计一套品牌识别方案"（Design brand identity package）	cip-design
"什么 Logo 风格适合我的行业？"（What logo style fits my industry?）	logo-design
"设计一张 Facebook 封面"（Design a Facebook cover）	banner-design
"给 Google 做广告横幅"（Create ad banners for Google）	banner-design
"做一个网站 Hero 横幅"（Make a website hero banner）	banner-design
"生成一个设置图标"（Generate a settings icon）	icon-design
"给我的应用做一套 SVG 图标"（Create SVG icons for my app）	icon-design
"设计一套图标"（Design an icon set）	icon-design

从这张表可以推断出路由的判别要点：颜色/一致性/语音类问题归 brand，令牌/CSS 变量类问题归 design-system，组件与深色模式类问题归 ui-styling，生成物类问题（Logo、样机、演示、横幅、图标）按产出物类型分流。其中"Design brand identity package"归 cip-design 而非 brand，说明完整交付物包的需求由 CIP 技能承接，这与下文"多技能组合"中 logo-design + cip-design 的组合互为印证。

多技能工作流（Multi-Skill Workflows）

单技能路由之外，路由文档还定义了三个典型的多技能串行工作流。

新项目搭建（New Project Setup）

1. brand → 定义识别
   - 颜色、字体、语音

2. design-system → 创建令牌
   - primitive、semantic、component 三层

3. ui-styling → 落地实现
   - 配置 Tailwind、添加组件

设计系统迁移（Design System Migration）

1. brand → 审计现状
   - 提取品牌颜色、字体

2. design-system → 令牌正式化
   - 建立三层架构

3. ui-styling → 更新代码
   - 替换硬编码值

组件创建（Component Creation）

1. design-system → 查阅规格
   - 按钮状态、尺寸、变体

2. ui-styling → 落地实现
   - 用 shadcn/ui + Tailwind 构建

值得注意的是迁移工作流的收尾步骤"替换硬编码值"有脚本可直接支撑：validate-tokens.cjs 会扫描指定目录，用正则检测硬编码的 hex 颜色、rgb 值、两位以上像素值和裸 rem 值（见 validate-tokens.cjs#L57-L78 的 patterns 定义），并给出"改用 var(--color-*) 等令牌"的替换建议；--fix 参数输出建议修复清单（源码注释明确为 no auto-fix），-i 参数可追加忽略目录。

技能依赖链（Skill Dependencies）

路由文档以一张依赖图描述了四个技能间的上游供给关系：

brand
    ↓ (colors, typography)
design-system
    ↓ (tokens, specs)
ui-styling
    ↓ (components)
Application Code

这条链在仓库中有具体的脚本证据：

brand → design-system：sync-brand-to-tokens.cjs 将 docs/brand-guidelines.md（品牌事实源）同步为 assets/design-tokens.json 与 assets/design-tokens.css，brand/SKILL.md 的 "Brand Sync Workflow" 明确该流程为"编辑规范 → 同步令牌 → 校验"；
design-system → ui-styling：generate-tokens.cjs 从令牌 JSON 生成 CSS 变量，并可通过 --format tailwind 直接产出 Tailwind 配置格式（其参数解析见 generate-tokens.cjs#L16-L46），ui-styling 的 tailwind-integration.md 与 tailwind-customization.md 承接后续集成；
ui-styling → Application Code：ui-styling 产出的 shadcn/ui 组件与 Tailwind 样式最终进入应用代码。

换言之，依赖链不是概念分层，而是有同步脚本、令牌生成脚本和集成文档串联起来的实际数据流。

快速命令（Quick Commands）

路由文档汇总了三类最常用的入口命令，以下完整继承原文档并补充源码中的参数说明。

品牌（Brand）：

node .claude/skills/brand/scripts/inject-brand-context.cjs
node .claude/skills/brand/scripts/validate-asset.cjs <path>

inject-brand-context.cjs 从 docs/brand-guidelines.md（默认路径）提取品牌上下文并输出为系统提示词片段，支持 --json 输出格式，可从 markdown 的颜色表格中解析 primary/secondary/neutral/semantic 四组色值；validate-asset.cjs 用于校验单个资产文件。

令牌（Tokens）：

node .claude/skills/design-system/scripts/generate-tokens.cjs -c tokens.json
node .claude/skills/design-system/scripts/validate-tokens.cjs -d src/

generate-tokens.cjs 的完整参数为：-c, --config <file>（必填，输入令牌 JSON）、-o, --output <file>（默认输出到 stdout）、-f, --format <type>（css | tailwind，默认 css）；它还能解析 {primitive.color.blue.600} 形式的令牌引用并递归解引用。validate-tokens.cjs 的完整参数为：-d, --dir <path>（必填，扫描目录）、--fix（输出建议修复）、-i, --ignore <dir>（追加忽略目录，默认已忽略 node_modules、.git、dist、build、.next）。

组件（Components）：

npx shadcn@latest add button card input

何时组合多个技能（When to Use Multiple Skills）

路由文档最后一节给出了"什么场景该启用多少个技能"的组合决策清单，完整继承如下：

八个全用：从零开始做完整品牌包（logo → CIP → presentation）；
brand + design-system + ui-styling：设计系统的搭建与落地；
logo-design + cip-design：带交付物样机的完整品牌识别方案；
logo-design + cip-design + slides：品牌路演——生成 Logo、创建 CIP 样机、制作 pitch deck；
banner-design + brand：社交媒体矩阵——跨平台品牌化横幅；
icon-design + design-system：匹配设计令牌与组件规格的定制图标集；
brand + design-system：只定义设计语言、不做实现；
design-system + ui-styling：把既有品牌落到代码、搭建组件库。

这套组合逻辑与 design/SKILL.md 的 "Workflows" 一节一致：Complete Brand Package 按 Logo（scripts/logo/generate.py）→ CIP（scripts/cip/generate.py --logo ...）→ Presentation（references/slides-create.md）三步推进；New Design System 按 brand → design-system → ui-styling 三层推进。

使用前提与边界

执行环境：Python 类脚本（logo/CIP/icon 的 search.py、generate.py）需要 Python 3，Windows 上以 python 替代 python3；Logo/CIP/Icon 的 AI 生成需要 GEMINI_API_KEY 环境变量与 pip install google-genai（Icon 因纯文本 SVG 输出不需要图像生成 API，Atlas Cloud 为 Logo 的可选 provider，需 ATLASCLOUD_API_KEY），详见 design/SKILL.md 的 Prerequisites 与 Setup 小节；
命令路径：文中快速命令均相对项目根目录执行，.claude/skills/... 路径结构与本仓库一致；
数据规模口径：路由文档中 "55 风格 / 30 色板 / 25 行业 / 50 交付物 / 15 图标风格" 的表述与 design/data 下各 CSV 的记录数量一致（Logo 风格 55 条、图标风格 15 条、CIP 交付物约 50 条），检索时以这些 CSV 为唯一数据源；
路由文档的角色：design-routing.md 本身是 design/SKILL.md References 表中标注的 "Design Routing" 条目，即 design 技能的选型总索引——先查它确定技能与脚本入口，再进入各子技能文档（logo-design.md、cip-design.md、icon-design.md、banner-sizes-and-styles.md 等）获取完整参数与工作流细节。