Communitygithub.com

majiayu000/claude-skill-registry

网页 UI 的设计思维与决策。适用于设计组件、布局、配色方案、排版或创建美观界面时使用。传授原则而非固定数值。

claude-skill-registry 是什么?

该技能(Skill)为 AI 编码代理(如 Claude Code、Cursor 等)提供了一套完整的前端设计决策框架。其核心哲学是“每个像素都有其目的,克制即为奢侈”,强调基于用户心理和上下文进行思考,而非盲目套用模板。技能强制要求代理遵循“选择性阅读规则”,在处理设计任务时,必须始终读取 `ux-psychology.md`(用户心理学)文件,并根据具体需求(如颜色、排版、动画)选择性读取其他参考文件。为了防止 AI 产生同质化输出,技能明确列出了诸如“Bento 网格”、“玻璃态”和“深青色/金融蓝”等常见的“AI 默认倾向”,并警告代理避免使用。它要求代理在用户指令不明确时主动提问,而非自行假设。在工作流程上,它指导代理先进行约束分析(时间线、内容、品牌、技术、受众),再运用 60-30-10 配色规则、黄金比例、8 点网格、排版缩放和动画缓动等原则进行决策,最后通过内置的 `scripts/ux_audit.py` 脚本进行审计,并可调用关联的 `web-design-guidelines` 技能进行代码层面的审核。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/majiayu000/claude-skill-registry/tree/HEAD/skills/design/frontend-design-congdon1207-agents-md

在你喜欢的 AI 中提问

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

文档

前端设计系统

哲学: 每一个像素都有其目的。克制即是奢华。用户心理驱动决策。 核心原则: 思考,不要死记硬背。询问,不要凭空假设。


🎯 选择性阅读规则(强制)

必读文件始终读取,可选文件仅当需要时读取:

文件状态何时读取
ux-psychology.md🔴 必读始终优先读取!
color-system.md⚪ 可选颜色/调色板决策
typography-system.md⚪ 可选字体选择/搭配
visual-effects.md⚪ 可选玻璃态、阴影、渐变
animation-guide.md⚪ 可选需要动画时
motion-graphics.md⚪ 可选Lottie、GSAP、3D
decision-trees.md⚪ 可选上下文模板

🔴 ux-psychology.md = 始终读取。其他文件 = 仅在相关时读取。


🔧 运行时脚本

执行以下脚本以进行审计(无需读取,直接运行):

脚本用途用法
scripts/ux_audit.pyUX 心理学与可访问性审计python scripts/ux_audit.py <项目路径>

⚠️ 关键:先询问,再假设(强制)

停下! 如果用户的请求是开放式的,不要默认选择你最喜欢的方案。

当用户提示含糊不清时,请询问:

未指定颜色? 询问:

“您偏好哪种调色板?(蓝色/绿色/橙色/中性色/其他?)”

未指定风格? 询问:

“您想要什么风格?(极简/大胆/复古/未来感/有机?)”

未指定布局? 询问:

“您有布局偏好吗?(单列/网格/不对称/全宽?)”

⛔ 应避免的默认倾向(反安全港):

AI 默认倾向为何不好换种思路
Bento 网格(现代俗套)每个 AI 设计都在用为什么这个内容需要网格?
Hero 分割(左/右)可预测且无聊巨型排版或垂直叙事如何?
网格/极光渐变“新”的懒惰背景什么才是激进的色彩搭配?
玻璃态AI 眼中的“高级感”纯色、高对比度平面如何?
深青色/金融蓝从紫色禁令中脱身的“安全港湾”为什么不用红色、黑色或霓虹绿?
“编排 / 赋能”AI 生成的文案人类会怎么说?
深色背景 + 霓虹发光过度使用,“AI 风格”品牌实际需要什么?
所有元素都圆角通用/安全哪里可以使用尖锐的、粗野主义的边缘?

🔴 “你选择的每一个‘安全’结构,都让你离通用模板更近一步。冒险。”


1. 约束分析(始终优先)

在任何设计工作之前,回答这些问题或询问用户:

约束问题为何重要
时间线有多少时间?决定复杂度
内容内容就绪还是占位?影响布局灵活性
品牌有现有指南吗?可能决定颜色/字体
技术使用什么技术栈?影响能力范围
受众目标用户是谁?驱动所有视觉决策

受众 → 设计方法

受众思考方向
Z 世代大胆、快速、移动优先、真实
千禧一代简洁、极简、价值驱动
X 世代熟悉、可信、清晰
婴儿潮一代易读、高对比度、简单
B2B专业、数据聚焦、信任
奢侈品克制的优雅、留白

2. UX 心理学原则

核心法则(内化这些)

法则原则应用
希克定律选择越多 = 决策越慢限制选项,使用渐进式披露
菲茨定律越大 + 越近 = 越易点击适当调整 CTA 大小
米勒定律工作记忆中约 7 项将内容分块分组
冯·雷斯托夫效应不同 = 令人难忘使 CTA 在视觉上与众不同
序列位置效应最先和最后最易被记住关键信息放在开头/结尾

情感设计层级

本能层次(瞬间)→ 第一印象:颜色、图像、整体感觉
行为层次(使用)  → 使用体验:速度、反馈、效率
反思层次(记忆)  → 事后:“我喜欢这告诉了我什么”

建立信任

  • 敏感操作上的安全指示
  • 相关位置的社会化证明
  • 清晰的联系/支持入口
  • 一致、专业的设计
  • 透明政策

3. 布局原则

黄金比例 (φ = 1.618)

用于比例和谐:
├── 内容 : 侧边栏 ≈ 62% : 38%
├── 每个标题尺寸 = 前一个 × 1.618(用于戏剧化缩放)
├── 间距可以遵循:小 → 中 → 大(每个 × 1.618)

8 点网格概念

所有间距和尺寸均为 8 的倍数:
├── 紧密:4px(微观元素的半步)
├── 小:8px
├── 中:16px
├── 大:24px, 32px
├── 特大:48px, 64px, 80px
└── 根据内容密度调整

关键尺寸原则

元素考虑因素
触摸目标舒适的轻触最小尺寸
按钮高度基于重要性层级
输入框与按钮高度匹配以对齐
卡片一致的内边距,有呼吸感
阅读宽度每行 45-75 个字符为佳

4. 色彩原则

60-30-10 规则

60% → 主色/背景(平静、中性的基底)
30% → 辅助色(支撑区域)
10% → 强调色(CTA、高亮、吸引注意力)

色彩心理学(用于决策)

如果需要...考虑色相避免
信任、平静蓝色系冲击性的红色
成长、自然绿色系工业灰
活力、紧迫感橙色、红色被动的蓝色
奢华、创造力深青色、金色、翡翠绿感觉廉价的亮色
干净、极简中性色压倒性的色彩

选择流程

  1. 行业是什么?(缩小选项)
  2. 想要什么情感?(选择主色)
  3. 浅色还是深色模式?(奠定基础)
  4. 如果未指定,询问用户

关于详细的色彩理论: color-system.md


5. 排版原则

缩放选择

内容类型缩放比例感觉
密集 UI1.125-1.2紧凑、高效
通用网页1.25平衡(最常见)
编辑类1.333可读、宽敞
Hero/展示1.5-1.618戏剧化冲击

搭配概念

对比 + 和谐:
├── 要有足够的差异以体现层级
├── 要有足够的相似以实现连贯
└── 通常是:展示字体 + 中性字体,或衬线 + 无衬线

可读性规则

  • 行长度:每行 45-75 个字符为佳
  • 行高:正文 1.4-1.6
  • 对比度:检查 WCAG 要求
  • 字号:网页正文 16px 以上

关于详细的排版: typography-system.md


6. 视觉效果原则

玻璃态(在适当时使用)

关键属性:
├── 半透明背景
├── 背景模糊
├── 用于定义边界的细微边框
└── ⚠️ **警告:** 标准的蓝色/白色玻璃态是现代庸俗设计。要么激进地使用,要么完全不用。

阴影层级

高度概念:
├── 元素越高 = 阴影越大
├── 垂直偏移 > 水平偏移(光从上方来)
├── 多层阴影 = 更真实
└── 深色模式:可能需要用发光代替

渐变使用

和谐的渐变:
├── 色轮上相邻的颜色(类似色)
├── 或者相同色相,不同明度
├── 避免刺眼的互补色对
├── 🚫 **无网格/极光渐变**(浮动色块)
└── 在项目之间进行剧烈变化

关于完整效果指南: visual-effects.md


7. 动画原则

时机概念

基于以下因素的持续时间:
├── 距离(越远 = 越长)
├── 尺寸(越大 = 越慢)
├── 重要性(关键 = 清晰)
└── 上下文(紧急 = 快,奢华 = 慢)

缓动选择

动作缓动函数原因
进入Ease-out减速,稳定下来
退出Ease-in加速,离开
强调Ease-in-out平滑,刻意
有趣Bounce有趣,充满活力

性能

  • 仅动画化 transform 和 opacity
  • 尊重 reduced-motion 偏好设置
  • 在低端设备上测试

关于动画模式: animation-guide.md, 关于高级动画: motion-graphics.md


8. “哇元素”检查清单

高级感指标

  • 慷慨的留白(奢华 = 呼吸空间)
  • 微妙的深度和层次感
  • 流畅、有目的的动画
  • 注重细节(对齐、一致性)
  • 连贯的视觉韵律
  • 自定义元素(不完全使用默认值)

信任建立器

  • 适当时的安全提示
  • 社会化证明 / 客户评价
  • 清晰的价值主张
  • 专业的图像
  • 一致的设计语言

情感触发器

  • 能唤起预期情感的 Hero 区域
  • 人性化元素(面孔、故事)
  • 进度/成就指示器
  • 令人愉悦的瞬间

9. 反模式(不要做什么)

❌ 懒惰设计指标

  • 未加思考就使用系统默认字体
  • 不匹配的库存图片
  • 不一致的间距
  • 过多竞争颜色
  • 没有层级结构的文字墙
  • 无法访问的对比度

❌ AI 倾向模式(避免!)

  • 每个项目都用相同的颜色
  • 深色 + 霓虹作为默认
  • 到处都是紫色/紫罗兰(紫色禁令 ✅)
  • 为简单的落地页使用 Bento 网格
  • 网格渐变和发光效果
  • 相同的布局结构 / Vercel 克隆
  • 不询问用户偏好

❌ 暗黑模式(不道德)

  • 隐藏成本
  • 虚假紧迫感
  • 强制操作
  • 欺骗性 UI
  • 确认羞辱

10. 决策流程总结

对于每一个设计任务:

1. 约束
   └── 时间线、品牌、技术、受众是什么?
   └── 如果不清楚 → 询问

2. 内容
   └── 存在什么内容?
   └── 内容的层级是什么?

3. 风格方向
   └── 什么适合当前上下文?
   └── 如果不清楚 → 询问(不要使用默认值!)

4. 执行
   └── 应用上述原则
   └── 对照反模式检查

5. 复盘
   └── “这服务于用户吗?”
   └── “这与我的默认方案不同吗?”
   └── “我会为此感到自豪吗?”

参考文件

关于特定领域的深入指导:


相关技能

技能何时使用
frontend-design(本技能)编码之前 - 学习设计原则(颜色、排版、UX 心理学)
web-design-guidelines编码之后 - 审计可访问性、性能和最佳实践

设计后工作流

在实现设计后,运行审计:

1. 设计    → 阅读 frontend-design 原则 ← 你在这里
2. 编码    → 实现设计
3. 审计    → 运行 web-design-guidelines 审查
4. 修复    → 处理审计中的发现

下一步: 编码后,使用 web-design-guidelines 技能审计你的实现,检查可访问性、焦点状态、动画和性能问题。


记住: 设计是思考,不是复制。每个项目都应基于其独特的上下文和用户进行全新的考量。避免现代 SaaS 安全港!

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

majiayu000/claude-skill-registry

Builds, edit or validate Agent Skill through conversational discovery. Use when the user requests to "Create an Agent", "Optimize an Agent" or "Edit an Agent".

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD agents while maintaining compliance

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Edit existing BMAD modules while maintaining coherence

majiayu000/claude-skill-registry

Analyzes current state and user query to answer BMad questions or recommend the next workflow or agent. Use when user says what should I do next, what do I do now, or asks a question about BMad

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Build AI agents with Google ADK Python (Agent Development Kit). Use for multi-agent systems, workflow agents (sequential/parallel/loop), Vertex AI deployment, tool integration, human-in-the-loop.

majiayu000/claude-skill-registry

Portfolio allocation and rebalancing optimizer. Manages asset allocation across stocks/cash/bonds, performs periodic rebalancing, and ensures diversification according to market regime and risk tolerance.

majiayu000/claude-skill-registry

Create a hilarious and ultra-realistic video of an anthropomorphic animal acting like a human vlogger in a real-world setting.

majiayu000/claude-skill-registry

Speech-to-text transcription and translation via OpenAI Audio API -- models, response formats, timestamps, prompting, streaming, chunking, and diarization

majiayu000/claude-skill-registry

BlockRun works with Claude Code and Google Antigravity.

majiayu000/claude-skill-registry

This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc.

majiayu000/claude-skill-registry

小省导购员数字人带货版即梦视频提示词生成系统,基于四大智能体协同(提示词生成师、质量管控师、知识库运维师、跨环节适配师),按照"主体+运动+场景+(镜头语言+光影+氛围)"公式输出中英文双版提示词,适配5s短视频。确保人物一致性、视觉连贯性、情绪连贯性,支持知识库智能复用和跨工具适配(Suno音乐、AI绘画),为数字人带货视频提供高质量提示词生成服务。

majiayu000/claude-skill-registry

Upload and manage files using Google Gemini File API via scripts/. Use for uploading images, audio, video, PDFs, and other files for use with Gemini models. Supports file upload, status checking, and file management. Triggers on "upload file", "file API", "upload image", "upload PDF", "upload video", "file management".

majiayu000/claude-skill-registry

CRITICAL: Use for MolyKit AI chat toolkit. Triggers on: BotClient, OpenAI, SSE streaming, AI chat, molykit, PlatformSend, spawn(), ThreadToken, cross-platform async, Chat widget, Messages, PromptInput, Avatar, LLM

majiayu000/claude-skill-registry

AI and machine learning workflow covering LLM application development, RAG implementation, agent architecture, ML pipelines, and AI-powered features.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Analyze images/audio/video with Gemini API (better vision than Claude). Generate images (Imagen 4), videos (Veo 3). Use for vision analysis, transcription, OCR, design extraction, multimodal AI.

majiayu000/claude-skill-registry

Skill for discovering and researching autonomous AI agents, tools, and ecosystems using the AgentFolio directory.

相关技能