Communitygithub.com

Cozythecoder/frontend-design-md

自动检测项目类型,分析意图,并从 60 多个参考模式中应用最佳设计系统。

frontend-design-md 是什么?

此技能专为 AI 代理(如 Claude Code、Cursor 或 Codex)设计,可自动分析您的 Web 项目并应用最合适的设计系统,涵盖超过 60 个经过策划的高质量参考模式(例如 Vercel、Linear、Apple)。当用户创建或修改 HTML/CSS/JS/React/Vue/Svelte 文件或发出“设计这个”或“改善 UI”等指令时,该技能会触发一个四阶段工作流:首先,通过扫描代码库中的关键字和设计令牌(颜色、排版、间距)来检测项目类别(例如 SaaS 着陆页、仪表板)。然后,它会运行预检协议,检查资产、技术堆栈和项目上下文。在第三阶段,它智能地调整所选设计系统以适应当前项目,映射颜色、排版和组件,而不是盲目复制粘贴。最后,它通过质量门(颜色对比度、响应式设计、可访问性)和验证脚本验证输出。该技能通过 `.design-system` 配置文件支持覆盖,并包含用于类别检测、令牌提取和适应生成的参考指南。

兼容平台✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/Cozythecoder/frontend-design-md/tree/HEAD/skills/design-systems

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

设计系统智能技能

自动检测项目类型,分析意图,并从 60 多个参考模式中应用最佳设计系统。

自动检测触发器

该技能在以下情况激活:

  • 用户创建/修改任何 Web 项目文件(HTML、CSS、JS、JSX、Vue、Svelte)
  • 用户说出“设计这个”、“让它好看”、“改善 UI”、“应用设计系统”
  • 用户提及特定类别:“着陆页”、“仪表板”、“作品集”、“电子商务”
  • 项目中未指定明确的设计系统

第一阶段:项目分析(自动)

在选择设计系统之前始终运行分析。

第 1 步:检测项目类别

扫描项目文件以确定类型:

# 检查指标
detections = {
    'saas-landing': ['pricing', 'signup', 'features', 'hero', 'testimonials'],
    'dashboard-app': ['dashboard', 'chart', 'table', 'sidebar', 'widget'],
    'e-commerce': ['product', 'cart', 'checkout', 'shop', 'inventory'],
    'portfolio': ['portfolio', 'gallery', 'project', 'creative', 'art'],
    'content-publication': ['blog', 'article', 'post', 'content', 'newsletter'],
    'brand-showcase': ['brand', 'story', 'about', 'mission', 'values'],
    'developer-tool': ['api', 'docs', 'code', 'terminal', 'github'],
    'service-business': ['service', 'contact', 'process', 'team', 'consulting']
}

第 2 步:分析当前状态

检查现有的设计令牌:

  • CSS/SCSS/Tailwind 配置文件中的颜色
  • 排版(font-family、font-size 声明)
  • 间距(margin、padding、gap 模式)
  • 组件(按钮类、卡片类)

第 3 步:匹配到设计系统库

与 60 多个参考模式进行比较:

项目类型推荐的设计系统
SaaS 着陆页linear.app, vercel.com, supabase.com, stripe.com, notion.so
仪表板/应用linear.app (UI), github.com, vercel.com/dashboard, supabase.com/dashboard
电子商务apple.com, shopify.com, nike.com
作品集framer.com, webflow.com, cargo.site
内容/博客medium.com, substack.com, stripe.com/blog
开发者工具vercel.com, github.com, docs.rs, nextjs.org
服务型业务cursor.com, intercom.com, webflow.com
品牌/代理tesla.com, apple.com, nike.com

第 4 步:置信度评分

计算匹配置信度:

confidence = (
  category_match * 0.40 +      # 内容是否匹配?
  token_similarity * 0.30 +      # 颜色/排版重叠?
  component_patterns * 0.20 +    # 按钮/卡片模式?
  layout_structure * 0.10        # 网格/flex 模式?
)

If confidence > 0.75: 自动建议顶级匹配
If 0.50-0.75: 提供 2-3 个备选方案
If < 0.50: 询问用户类别偏好

第二阶段:预检协议

资产检查清单

在应用任何设计系统之前:

  1. 检查 project-context.md

    • 它是否存在于项目根目录?
    • 如果没有:根据模板创建,包含项目名称、目标、受众
  2. 分析当前资产

    # 自动运行
    python3 ~/.claude/skills/design-systems/scripts/inspect-project.py
    

    检查项:

    • Logo 是否存在?(首选 SVG)
    • 产品图片?(透明 PNG 用于 hero 区域?)
    • 是否已定义配色方案?
    • 是否已设置排版?
    • 现有的组件库?
  3. 确定组合层次结构

    • Hero 元素:最大的视觉元素(产品截图、插图、标题)
    • 支持元素:功能、优势、社交证明
    • 装饰元素:装饰性元素、图案
  4. 验证技术约束

    • 检测到的框架(React、Vue、原生等)
    • CSS 方法(Tailwind、CSS-in-JS、SCSS 等)
    • 动画能力(是否加载了 GSAP?Framer Motion?)
    • 性能预算(移动优先?桌面优先?)

第三阶段:设计系统应用

第 1 步:选择并加载

基于分析,加载推荐的 DESIGN.md:

推荐:Linear.app 设计系统
置信度:87%

匹配原因:
- 检测到 SaaS 着陆页(定价、功能部分)
- 检测到深色模式偏好
- 简洁的排版(类似 Inter)
- 存在基于卡片的布局模式

第 2 步:适应项目

不要直接复制粘贴。 根据项目分析进行调整:

颜色:

  • 如果项目有品牌颜色:映射到设计系统角色
  • 如果没有颜色:直接使用设计系统调色板
  • 示例:“您的蓝色 #3B82F6 → 主强调色角色”

排版:

  • 如果使用 Inter/System 字体:保留设计系统比例
  • 如果使用不同字体:调整大小/粗细
  • 示例:“Roboto 替代 Inter → 调整粗细 400→500”

间距:

  • 检查现有间距比例
  • 映射到设计系统,如果一致则保留

组件:

  • 将现有类映射到设计系统模式
  • 示例:“您的 .btn-primary → 设计系统主要按钮”

第 3 步:实施清单

按优先级顺序应用设计系统:

  1. 基础(关键)

    • 颜色 CSS 变量已映射
    • 排版比例已定义
    • 间距系统已建立
    • 基础样式重置/标准化已应用
  2. 布局(高)

    • 区块间距(hero、内容、页脚)
    • 容器宽度(max-width、padding)
    • 网格系统(如果适用)
  3. 组件(中)

    • 按钮(主要、次要、幽灵)
    • 卡片(如果使用)
    • 表单/输入(如果使用)
    • 导航(页眉、页脚)
  4. 润色(低)

    • 阴影/层级
    • 边框半径一致性
    • 聚焦状态
    • 悬停过渡

第四阶段:验证

质量门

应用后运行:

视觉一致性检查:

# 检查违规行为
violations = []

# 1. 颜色数量
if unique_colors > 8:
    violations.append("颜色过多 - 简化调色板")

# 2. 排版比例
if font_sizes > 12:
    violations.append("排版不系统 - 合并字体大小")

# 3. 间距一致性
if spacing_base not in [4, 8, 16]:
    violations.append("间距不遵循 4/8px 网格")

# 4. 触控目标
if touch_targets < 44:
    violations.append("触控目标低于 44px")

无障碍检查:

  • 文本颜色对比度 >= 4.5:1
  • 聚焦指示器可见
  • 尊重减少动效设置
  • 需要时添加 ARIA 标签

性能检查:

  • 无布局抖动的动画
  • 图片已优化
  • 字体子集化(如果是自定义字体)

参考资料

设计系统分析

适应指南

验证

特定类别模式

脚本

  • scripts/analyze-project.py — 检测类别、当前令牌
  • scripts/match-design-system.py — 与库对比
  • scripts/validate-application.py — 质量门
  • scripts/generate-adaptation.py — 将现有内容映射到设计系统
  • scripts/inspect-assets.py — 检查图片、Logo、品牌资产

设计系统库

在 ../design-systems/ 中按类别组织的 60 多个系统:

SaaS / 开发者工具

  • linear.app(深色,Inter,510 字重)
  • vercel.com(Geist,阴影边框)
  • supabase.com(温暖,受 PostgreSQL 启发)
  • stripe.com(内容丰富,渐变)
  • notion.so(友好,圆角)
  • github.com(功能性强,密集)
  • cursor.com(编辑器聚焦,语法高亮)

电子商务 / 产品

  • apple.com(SF Pro,高对比度,药丸形 CTA)
  • shopify.com(polarized,Polaris 令牌)
  • nike.com(大胆,动感,图片优先)

创意 / 作品集

  • framer.com(俏皮,渐变,有弹性)
  • webflow.com(专业,结构化)

内容 / 出版物

  • medium.com(阅读聚焦,衬线正文)
  • substack.com(温暖,以通讯为中心)

企业

  • ibm.com(Carbon 设计,系统化)
  • salesforce.com(功能性强,密集)

汽车 / 奢侈品

  • tesla.com(极简,产品为中心)
  • ferrari.com(戏剧性,红色强调)
  • bmw.com(技术性,精确)

使用流程

用户:“为我的 SaaS 构建一个着陆页”
↓
技能:分析项目...
       检测到:SaaS 着陆页意图
       当前状态:无设计系统
↓
技能:推荐 linear.app(87% 匹配)
       提供备选方案:vercel.com, stripe.com
↓
用户:“使用 Linear 风格”
↓
技能:运行预检协议
       - 创建 project-context.md
       - 分析资产
       - 检查技术栈
↓
技能:应用 Linear 设计系统
       - 映射颜色令牌
       - 设置排版比例
       - 实施组件
↓
技能:验证输出
       - 颜色对比度检查
       - 间距一致性
       - 质量门审查
↓
输出:采用 Linear 风格设计的项目

配置

通过在项目根目录创建 .design-system 文件来覆盖自动检测:

{
  "system": "linear.app",
  "theme": "dark",
  "adaptations": {
    "primaryColor": "#3B82F6",
    "fontFamily": "Inter"
  }
}

此技能将您 60 多个设计系统收藏与史诗级工作流相结合:自动检测、预检、验证和智能适配。

相关技能