mcpField
D
design-system-analyzer

design-system-analyzer

github.com/nakanosanku设计与 UI16241 次安装42 周前更新
代码仓库

关于 design-system-analyzer

design-system-analyzer 通过 ChromeDevTools 检查网站的 CSS,提取设计令牌、动画、交互状态和布局信息,并按指定模板生成设计系统提示词。它面向需要将现有网站视觉规范整理成结构化提示词的设计与开发工作。

主要功能

  1. 01提取 CSS 变量与设计令牌
  2. 02检查关键帧、动画和过渡效果
  3. 03分析交互状态与字体布局
  4. 04按指定模板填充设计系统提示词

适用场景

  1. 01从现有网站整理颜色、间距和字体规范
  2. 02为界面实现生成包含动画和组件样式的提示词

MCP 相关

工作流通过 Chrome DevTools MCP 导航并检查网站;不描述其提供 MCP 服务。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/nakanosanku/ohmyskills --skill design-system-analyzer

安装后在 Claude Code 中输入/design-system-analyzer确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
references/
analysis-guide.md
design-system-template.md
setup-guide.md

详细介绍

设计系统分析器

通过 ChromeDevTools 分析网站,提取深层 CSS 逻辑(关键帧、过渡效果、设计令牌),并生成全面的设计系统提示词。

关键规则

  1. 必须严格按照 references/design-system-template.md 中的结构输出最终提示词
  2. 必须限制提取数据,防止上下文溢出(限制请参阅 analysis-guide.md)
  3. 必须使用提取或观察到的值填写所有模板占位符
  4. 绝不跳过任何章节——数据不可用时,请使用“未观察到”

最佳实践:使用自己的 Chrome

为获得最佳体验(无需处理 CAPTCHA,共享登录 Cookie),建议用户使用以下命令运行 Chrome: chrome.exe --remote-debugging-port=9222 (详情请参阅 references/setup-guide.md)


工作流概览

[1. Navigate] → [2. Anti-Bot Check] → [3. Deep Extraction] → [4. Synthesize to Template]

重要:不要截图。截图会占用过多上下文,而且没有必要——所有视觉数据都从 CSS 中提取。


步骤 1:导航与反机器人检查

mcp__chrome-devtools__navigate_page (url: "<target-url>")

立即检查是否遇到机器人验证:

() => {
  const text = document.body.innerText.toLowerCase();
  const title = document.title.toLowerCase();
  if (text.includes('cloudflare') || text.includes('verify you are human') || title.includes('just a moment')) {
    return 'CHALLENGE_DETECTED';
  }
  return 'OK';
}

如果检测到验证挑战:

  1. 暂停所有操作。
  2. 告知用户:“检测到机器人防护。请在浏览器中手动完成 CAPTCHA,然后在此处确认。”
  3. 等待用户确认后再继续。

步骤 2:深度 CSS 提取

按照 references/analysis-guide.md 中的顺序运行提取脚本:

顺序脚本用途最大数量
1CSS 变量与设计令牌颜色、间距、排版变量50 个设计令牌
2动画与关键帧@keyframes、动画用法、过渡效果10 个关键帧、15 个过渡效果
3交互状态:hover、:focus、:active 规则15 条规则
4排版关键元素的字体栈7 个元素
5布局与间距边框圆角、间隙、阴影各 5 个
6技术栈框架检测-

重要:每个脚本都内置了限制。不要修改脚本以提取更多数据。


步骤 3:整合到模板

必须严格按照 references/design-system-template.md 中的模板结构生成输出。

模板映射表
提取的数据模板章节备注
tokens.colorsDesign Token System > Colors格式为表格
tokens.spacingSpacing, Radius & Borders包含圆角值
tokens.typographyTypography包含字体栈
排版脚本Typography > Font Stacks, Type Scale计算后的样式
keyframesAnimation & Motion > Key Animations完整关键帧定义
animationUsageAnimation & Motion > Timing时长、缓动
transitionsAnimation & Motion > Timing常见模式
interactionsComponent Styling > State Transitions悬停/聚焦效果
布局采样器Layout Principles间距系统
技术栈Implementation NotesTailwind/CSS 说明
输出格式检查清单

输出前,请确认以下所有章节均已包含:

  • <role> 块(从模板原样复制)
  • <design-system> 包装标签
  • ## Design Philosophy,包含 Core Principles、Vibe、Historical Context
  • ## Design Token System,包含 Colors 表格、Typography、Spacing
  • ## Component Styling Principles,包含 Buttons、Cards、Form Inputs
  • ## Layout Principles,包含 Spacing System、Grid、Responsive
  • ## The "Signature" Factor,包含 3 个必需元素
  • ## Animation & Motion,包含 Philosophy、Timing、Key Animations
  • ## Accessibility Constraints
  • ## Anti-Patterns,包含视觉和交互方面的禁忌
  • ## Implementation Notes,包含针对具体技术的指导
  • ## Aesthetic Checklist,包含 4 项验证内容
  • 闭合标签 </design-system>

资源

评论

支持 Markdown