UI设计工具包专业版

核心能力

免费版 vs 专业版对比

输入: 用户提供免费版 vs 专业版对比所需的指令和必要参数。 处理: 按照skill规范执行免费版 vs 专业版对比操作,遵循单一意图原则。 输出: 返回免费版 vs 专业版对比的执行结果,包含操作状态和输出数据。

视觉层次

执行视觉层次操作,处理用户输入并返回结果。

输入: 用户提供视觉层次所需的参数和指令。

输出: 返回视觉层次的处理结果。

• 执行视觉层次操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考视觉层次相关配置参数进行设置

排版规范

执行排版规范操作,处理用户输入并返回结果。

输入: 用户提供排版规范所需的参数和指令。

输出: 返回排版规范的处理结果。

• 执行排版规范操作，处理输入数据并返回结果
• 验证执行结果，确认输出符合预期格式
• 参考排版规范相关配置参数进行设置

能力覆盖范围

本skill还覆盖以下能力场景: 企业级、设计工具包、支持设计系统、可访问性与组件库、适配团队协作与大、型项目、面向团队与企业用、核心能力、涵盖免费版全部能、Design、System、构建与维护、Tokens、深度规范与自动化、组件库抽象与复用、多主题与品牌切换、Motion、设计考虑、协作规范、设计文档与。这些能力在上述核心功能中均有对应处理逻辑。

适用场景

场景一:设计系统构建

构建完整的企业设计系统。

详细代码示例已移至 references/detail.md

场景二:可访问性深度规范

实现 WCAG 2.1 AA 级合规。

// a11y-checklist.js - 可访问性检查清单
export const a11yChecklist = {
  // 感知(Perceivable)
  perceptible: {
    '1.1.1 非文本内容': '所有图片有 alt 文本(装饰性用 alt="")',
    '1.3.1 信息与关系': '使用语义化 HTML(header/nav/main/article)',
    '1.4.3 对比度(最低)': '正文文字对比度 >= 4.5:1',
    '1.4.3 对比度(大文字)': '18px+ 文字对比度 >= 3:1',
    '1.4.4 文字缩放': '支持 200% 缩放不丢失功能',
    '1.4.11 非文字对比度': 'UI 组件对比度 >= 3:1',
  },

  // 可操作(Operable)
  operable: {
    '2.1.1 键盘可访问': '所有功能可通过键盘操作',
    '2.1.2 无键盘陷阱': '焦点不会被组件困住',
    '2.4.3 焦点顺序': 'DOM 顺序与视觉顺序一致',
    '2.4.7 焦点可见': '聚焦状态清晰可见',
    '2.5.5 目标尺寸': '触摸目标 >= 44x44px',
  },

  // 可理解(Understandable)
  understandable: {
    '3.2.1 可预测': '组件行为一致',
    '3.2.2 输入标识': '表单字段有清晰标签',
    '3.3.1 错误识别': '错误信息清晰描述',
    '3.3.2 标签或指令': '提供输入指导',
  },

  // 健壮(Robust)
  robust: {
    '4.1.2 名称、角色、值': 'ARIA 属性正确使用',
    '4.1.3 状态消息': '使用 role="status" 或 aria-live',
  },
}

// 自动化检测工具集成
// 推荐工具:
// - axe-core: 自动化可访问性检测
// - Lighthouse: Chrome 内置审计
// - jest-axe: Jest 集成测试

"""
npm install --save-dev axe-core jest-axe

module.exports = {
  setupFilesAfterEnv: ['jest-axe/extend-expect'],
}

import { render } from '@testing-library/react'
import { axe } from 'jest-axe'
import { Button } from './Button'

test('Button 满足可访问性标准', async () => {
  const { container } = render(点击)
  const results = await axe(container)
  expect(results).toHaveNoViolations()
})
"""

场景三:组件库抽象

构建可复用的组件库。

详细代码示例已移至 references/detail.md

场景四:多主题切换

支持多品牌动态切换。

/* themes/brand-a.css */
:root[data-theme="brand-a"] {
  --color-brand-50: #eff6ff;
  --color-brand-500: #3b82f6;
  --color-brand-600: #2563eb;
  --color-brand-700: #1d4ed8;
}

/* themes/brand-b.css */
:root[data-theme="brand-b"] {
  --color-brand-50: #f0fdf4;
  --color-brand-500: #22c55e;
  --color-brand-600: #16a34a;
  --color-brand-700: #15803d;
}

/* themes/brand-c.css */
:root[data-theme="brand-c"] {
  --color-brand-50: #faf5ff;
  --color-brand-500: #a855f7;
  --color-brand-600: #9333ea;
  --color-brand-700: #7e22ce;
}

// 主题切换
function setBrand(brand) {
  document.documentElement.setAttribute('data-theme', `brand-${brand}`)
  localStorage.setItem('brand', brand)
}

// 初始化
const savedBrand = localStorage.getItem('brand') || 'a'
setBrand(savedBrand)

使用流程

1. 初始化设计系统

mkdir my-design-system && cd my-design-system
npm init -y

npm install clsx
npm install -D tailwindcss storybook @storybook/react

2. 定义设计令牌

cp templates/design-tokens.js ./src/
cp templates/tailwind.config.js ./

3. 搭建组件库

npx storybook init

mkdir -p src/components/ui

命令参数说明

1. -live: 命令参数,用于指定操作选项
2. -D: 命令参数,用于指定操作选项
3. -design-system: 命令参数,用于指定操作选项
4. -library: 命令参数,用于指定操作选项
5. --color-brand-600: 命令参数,用于指定操作选项

结果处理: 执行完成后,查看输出结果确认操作状态。成功时输出包含处理摘要和结果数据;失败时根据错误信息排查问题,参考错误处理章节获取恢复步骤。

命令参数说明

• --color-brand-50: 命令参数,用于指定操作选项
• -D: 命令参数,用于指定操作选项
• --save-dev: 命令参数,用于指定操作选项
• -theme: 命令参数,用于指定操作选项
• --color-brand-500: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项
• -expect: 命令参数,用于指定操作选项
• --color-brand-700: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

命令参数说明

• -D: 命令参数,用于指定操作选项

输入格式

输出格式

{
  "success": true,
  "data": {
    "overall_grade": "A",
    "total_score": 92,
    "max_score": 100,
    "summary": "处理完成",
    "details": [
      {
        "item": "代码风格",
        "status": "pass",
        "score": 95,
        "comment": "符合规范"
      },
      {
        "item": "安全合规",
        "status": "warn",
        "score": 80,
        "comment": "符合规范"
      }
    ],
    "improvements": [
      {
        "priority": "high",
        "suggestion": "建议优化",
        "expected_gain": "+5分"
      },
      {
        "priority": "medium",
        "suggestion": "建议优化",
        "expected_gain": "+3分"
      }
    ]
  },
  "error": null
}

异常处理

依赖说明

运行环境

• Agent 平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
• 操作系统: Windows / macOS / Linux
• Node.js: 18 及以上

第三方依赖

API Key 配置

• 本 Skill 无需任何 API Key
• 设计系统为本地构建,不依赖云服务
• Figma 集成可能需要 Figma API Token(可选)

可用性分类

• 分类: MD+EXEC()
• 说明: 基于Markdown的AI Skill,。专业版支持设计系统建设、设计令牌管理与可访问性规范,适合企业级产品设计与团队协作。

案例展示

示例1: 基础用法

输入:

{
  "content": "示例内容",
  "strict_level": "normal"
}

输出:

评级: B级(良好) - 总分: 85/100

检查详情:
- 代码风格: 通过(95分) - 检查通过
- 安全合规: 警告(75分) - 检查通过
- 无障碍性: 通过(85分) - 检查通过

改进建议:
1. [高优先级] 建议优化
2. [中优先级] 建议优化

示例2: 进阶用法

输入:

{
  "content": "示例内容",
  "strict_level": "strict"
}

输出:

评级: C级(及格) - 总分: 70/100

检查详情:
- 代码风格: 通过(90分) - 检查通过
- 安全合规: 不通过(50分) - 检查通过
- 无障碍性: 警告(70分) - 检查通过

改进建议:
1. [高优先级] 建议优化
2. [高优先级] 建议优化
3. [低优先级] 建议优化

示例3: 边界情况 - 边界情况

输入:

{
  "content": "示例内容"
}

输出:

评级: D级(不及格) - 总分: 45/100

检查详情:
- 代码风格: 不通过(40分) - 检查通过
- 安全合规: 不通过(30分) - 检查通过
- 无障碍性: 通过(65分) - 检查通过

改进建议:
1. [紧急] 建议优化
2. [高优先级] 建议优化

常见问题

Q1: 设计系统如何保证一致性?

通过将所有设计令牌集中在统一文件,团队成员只能使用预定义的令牌。配合设计 lint 工具(如 Stylelint)检测硬编码值。

Q2: 设计令牌如何同步到代码?

使用 Style Dictionary 等工具,从单一数据源自动生成各平台格式(CSS 变量、iOS Swift、Android XML)。

Q3: 可访问性合规需要达到什么级别?

建议至少达到 WCAG 2.1 AA 级。部分场景(政府、医疗)可能要求 AAA 级。使用 axe-core 自动化检测 + 人工评审。

Q4: 组件库如何版本管理?

• 遵循语义化版本(SemVer)
• 破坏性变更需迁移指南
• 使用 Changesets 管理版本
• 通过 npm/内部 registry 分发

Q5: 专业版与免费版的迁移?

零迁移成本。专业版是免费版的超集,设计原则完全兼容。升级后原有组件继续可用,新特性按需启用。

Q6: 如何与 Figma 协作?

使用 Figma Variables 同步设计令牌,组件命名与代码一一对应,变更通过 PR 评审。专业版提供详细的协作规范。

错误处理

已知限制

-

-

-