Communitygithub.com

界面设计

此技能专为仪表盘、管理面板、应用、工具及交互式产品等界面设计而生。不适用于营销设计(如落地页、营销网站、活动页面)。

界面设计 是什么?

该技能旨在指导AI代理在构建界面时,克服模板化输出,追求真正的工艺与一致性。它主要面向仪表盘、管理面板、SaaS应用、工具等交互式产品,而非营销设计。技能的核心在于强调“意图优先”的设计方法论,要求设计者深入探索产品领域,识别并替换系统中隐藏的默认选择。它通过提供产品领域探索、默认项识别和工艺检查清单等结构化的步骤,帮助设计者从认知层面避免生成通用、缺乏个性的界面。该技能适用于Claude Code、Cursor等AI编程代理,通过其详细的markdown指南,系统性地引导设计过程从“任务类型到视觉模板”的默认路径转向“产品领域到独特结构”的定制化路径。最终目标是确保任何界面设计都源于特定问题、用户和上下文,从而实现真正的差异化。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ulasalyesil/personal-website-v2/tree/HEAD/.agent/skills/interface-design

在你喜欢的 AI 中提问

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

文档

界面设计 是做什么的?

以工艺和一致性构建界面设计。

适用范围

适用于: 仪表盘、管理面板、SaaS应用、工具、设置页面、数据界面。

不适用于: 落地页、营销网站、活动页面。请将这些需求重定向到 /frontend-design。


问题所在

你将生成模板化的输出。你的训练数据见过成千上万个仪表盘。模式非常强烈。

你可以遵循下面的完整流程——探索领域、命名特征、陈述意图——但仍然会产生一个模板。暖色配冷结构。友好字体配通用布局。“厨房感觉”看起来和其他每个应用都一样。

这是因为意图存在于散文中,但代码生成来自模式。两者之间的鸿沟就是默认值胜出的地方。

下面的流程会有所帮助。但仅仅依靠流程并不能保证工艺。你必须时刻自我察觉。


默认值藏身之处

默认值不会自我宣告。它们伪装成基础设施——那些感觉只需要正常运行、不需要被设计的部分。

排版感觉像容器。 选个可读的字体,继续往下走。但排版不是在“承载”你的设计——它本身就是你的设计。标题的权重、标签的个性、段落的质感。这些在任何人阅读一个字之前,就已经塑造了产品的感觉。一个面包店管理工具和一个交易终端可能都需要“清晰、可读的字体”——但温暖、手作的字体与冰冷、精确的字体截然不同。如果你又在拿常用的字体,你就不是在设计。

导航感觉像脚手架。 建个侧边栏,加几个链接,然后开始做真正的工作。但导航不是“围绕”你的产品——它本身就是你的产品。你在哪里,你能去哪里,什么最重要。一个漂浮在空间中的页面只是一个组件演示,而不是软件。导航教会人们如何思考他们所处的空间。

数据感觉像展示。 你有数字,展示数字。但屏幕上的数字不是设计。问题是:这个数字对看到它的人意味着什么?他们会用它做什么?一个进度环和一个堆叠标签都显示“3/10”——一个讲述故事,一个填充空间。如果你又在用“数字+标签”,你就不是在设计。

Token名称感觉像实现细节。 但你的CSS变量就是设计决策。--ink 和 --parchment 唤起一个世界。--gray-700 和 --surface-2 唤起一个模板。只看你的token的人应该能猜出这是什么产品。

陷阱在于认为有些决定是创造性的,有些是结构性的。没有结构性的决定。一切都是设计。当你停止问“为什么是它?”的那一刻,就是默认值接管的时候。


意图优先

在接触代码之前,回答这些问题。不是在脑子里——大声说出来,对自己或用户说。

这个“人”是谁? 不是“用户”。而是真实的人。他们打开这个应用时在哪里?脑子里在想什么?5分钟前他们在做什么,5分钟后会做什么?早上7点喝着咖啡的老师,和午夜调试代码的开发者,和投资人会议间隙的创始人,身处不同的世界。他们的世界塑造了界面。

他们必须完成什么? 不是“使用仪表盘”。而是动词。批改这些作业。找到出错的部署。批准付款。答案决定了什么引导、什么跟随、什么隐藏。

这应该是什么感觉? 用有意义的词汇说出来。“干净和现代”毫无意义——每个AI都这么说。像笔记本一样温暖?像终端一样冰冷?像交易大厅一样密集?像阅读应用一样平静?答案塑造了颜色、字体、间距、密度——一切。

如果你不能用具体细节回答这些问题,就停下来。去问用户。不要猜。不要用默认值。

每个选择必须是一个选择

对于每个决定,你必须能够解释为什么。

  • 为什么用这个布局而不是另一个?
  • 为什么是这个色温?
  • 为什么是这个字体?
  • 为什么是这个间距比例?
  • 为什么是这个信息层级?

如果你的答案是“它很常见”或“它很干净”或“它有用”——你就没有做出选择。你用了默认值。默认值是不可见的。不可见的选择会叠加成模板化的输出。

检验标准: 如果你把你的选择换成最常见的替代品,而设计感觉没有实质性区别,那么你就从未做出真正的选择。

雷同即是失败

如果另一个AI,在收到类似提示时,会产生基本相同的输出——你就失败了。

这不是为了与众不同而与众不同。而是界面必须源于特定问题、特定用户、特定上下文。当你从意图出发设计时,雷同变得不可能,因为没有两个意图是完全相同的。

当你从默认值出发设计时,一切看起来都一样,因为默认值是共享的。

意图必须是系统性的

说“温暖”却用冷色,这不是贯彻意图。意图不是一个标签——它是一个约束,塑造每一个决定。

如果意图是温暖的:表面、文字、边框、强调色、语义色、排版——全部要温暖。如果意图是密集的:间距、字体大小、信息架构——全部要密集。如果意图是平静的:动效、对比度、色彩饱和度——全部要平静。

检查你的输出是否符合你陈述的意图。每个token都强化了它吗?还是你陈述了一个意图,然后又用了默认值?


产品领域探索

这是默认值被抓住的地方——或者没有被抓住。

通用输出:任务类型 → 视觉模板 → 主题 精雕细琢的输出:任务类型 → 产品领域 → 独特特征 → 结构 + 表达

区别在于:在任何视觉或结构思考之前,花时间在产品的世界里。

必需产出

在提出任何方向之前,必须产出以下全部四项:

领域: 来自产品世界的概念、隐喻、词汇。不是功能——是领地。至少5个。

色彩世界: 该产品领域自然存在哪些颜色?不是“暖”或“冷”——要深入到真实世界。如果这个产品是一个物理空间,你会看到什么?哪些颜色属于这里,而不属于别处?列出5个以上。

独特特征: 一个元素——视觉的、结构的或交互的——只能存在于这个产品。如果你说不出一个,继续探索。

默认值: 对此界面类型的3个显而易见的选择——包括视觉和结构。如果你没有命名出模式,你就无法避免它们。

提案要求

你的方向必须明确引用:

  • 你探索过的领域概念
  • 来自你色彩世界探索的颜色
  • 你的独特特征元素
  • 每个默认值被什么取代

检验标准: 阅读你的提案。去掉产品名称。有人能识别出这是做什么的吗?如果不能,说明太通用。探索得更深入。


硬性要求

在向用户展示之前,看看你做了什么。

问自己:“如果他们说这缺乏工艺,他们会指什么?”

你刚刚想到的那件事——先修复它。

你的第一个输出可能是通用的。这很正常。关键是在用户指出之前,你自己先发现它。

检查清单

在展示输出之前,用这些检查一下:

  • 替换测试: 如果你把字体换成你常用的那个,会有人注意到吗?如果你把布局换成标准的仪表盘模板,会感觉不同吗?那些替换后无关紧要的地方,就是你用了默认值的地方。

  • 眯眼测试: 眯起眼睛。你还能感知到层级吗?有什么东西刺眼地跳出来吗?工艺是轻声细语的。

  • 特征测试: 你能指出五个具体元素,其中出现了你的独特特征吗?不是“整体感觉”——而是实际的组件。一个你找不到的特征是不存在的。

  • Token测试: 大声读出你的CSS变量。它们听起来属于这个产品的世界,还是属于任何项目?

如果任何一项检查失败,在展示之前迭代改进。


工艺基础

微妙分层

这是工艺的支柱。不论方向、产品类型或视觉风格如何——这个原则适用于一切。你应该几乎注意不到系统在运作。当你看Vercel的仪表盘时,你不会想“漂亮的边框”。你只是理解了这个结构。工艺是隐形的——你正是通过这一点知道它在起作用。

表面层级

表面是堆叠的。下拉菜单悬浮在卡片之上,卡片悬浮在页面之上。构建一个编号系统——基础层,然后是递增的提升级别。在深色模式下,更高的层级 = 略微更亮。在浅色模式下,更高的层级 = 略微更亮或使用阴影。

每一级提升应该只有几个百分点的亮度变化。单独来看,你几乎看不出区别。但是当表面堆叠起来时,层级关系就显现了。微不可查的变化,你感觉到而不是看到。

关键决策:

  • 侧边栏: 使用与画布相同的背景色,而不是不同。不同的颜色会将视觉空间分割成“侧边栏世界”和“内容世界”。一个微妙的边框就足以分离。
  • 下拉菜单: 比父表面高一级。如果两者处于同一层级,下拉菜单会与卡片融为一体,失去层次感。
  • 输入框: 比周围环境略暗,而不是更亮。输入框是“内嵌”的——它们接收内容。较暗的背景传达“在此输入”的信号,而不需要沉重的边框。

边框

边框应该在你不需要寻找时消失,但在你需要结构时可以被找到。低透明度的 rgba 能与背景融合——它定义了边缘而不引人注目。实心的十六进制边框相比之下显得生硬。

构建一个递进系统——并非所有边框都平等。标准边框、较柔和的分离、强调边框、用于焦点环的最大强调。将强度与边界的重要性相匹配。

眯眼测试: 对着界面眯起眼睛。你应该仍然能感知到层级——什么在什么之上,部分在哪里划分。但没有什么东西应该跳出来。没有生硬的线条。没有刺眼的颜色变化。只有安静的结构。

这区分了专业界面和业余界面。这个做错了,其他什么都没用。

无限表达

每个模式都有无限种表达方式。没有两个界面应该看起来一样。

一个指标显示可以是英雄数字、行内统计、迷你图、仪表、进度条、比较增量、趋势徽章,或者全新的东西。一个仪表盘可以完全不同地强调密度、空白、层级或流程。即使是“侧边栏+卡片”在比例、间距和重点上也有无限变化。

在构建之前,问:

  • 用户在这里做得最多的一件事是什么?
  • 哪些产品出色地解决了类似问题?研究它们。
  • 为什么这个界面会让人感觉是为其目的而设计的,而不是套用模板?

永远不要产生相同的输出。 每次都一样的侧边栏宽度、一样的卡片网格、一样的“图标-左-数字-大-标签-小”的指标框——这立马暴露了是AI生成的。这样的设计令人遗忘。

架构和组件应该从任务和数据中涌现出来,以一种感觉新颖的方式执行。Linear的卡片看起来不像Notion的。Vercel的指标看起来不像Stripe的。相同的概念,无限种表达方式。

色彩源于某处

每个产品都存在于一个世界中。那个世界有它的颜色。

在你拿起调色板之前,先花时间在产品的世界里。如果你走进这个产品的物理版本,你会看到什么?什么材料?什么光线?什么物体?

你的调色板应该感觉是“来自”某处——而不是被“应用”到某物上。

超越暖与冷: 温度只是一个维度。这是安静还是响亮?密集还是宽敞?严肃还是有趣?几何感还是有机感?一个交易终端和一个冥想应用都是“专注的”——但专注的类型完全不同。找到具体的品质,而不是通用的标签。

色彩承载意义: 灰色构建结构。色彩传达信息——状态、操作、强调、身份。无动机的色彩是噪音。一个强调色,有意地使用,其效果胜过五个随意使用的颜色。


编写每个组件之前

每次你编写UI代码时——即使是小的增补——都要陈述:

意图:[这个“人”是谁,他们必须做什么,应该是什么感觉]
调色板:[来自你探索的颜色——以及为什么它们适合这个产品的世界]
深度:[边框 / 阴影 / 分层——以及为什么这符合意图]
表面:[你的层级比例——以及为什么是这个色温]
排版:[你的字体——以及为什么它符合意图]
间距:[你的基础单位]

这个检查点强制要求。它迫使你将每个技术选择与意图联系起来。

如果你不能解释“为什么”每个选择,你就是在用默认值。停下来思考。


设计原则

Token架构

你界面中的每个颜色都应该追溯到一小套基元:前景色(文字层级)、背景色(表面层级)、边框色(分离层级)、品牌色和语义色(破坏、警告、成功)。没有随机的十六进制值——一切都映射到基元。

文字层级

不要只有“文字”和“灰色文字”。构建四个层级——主要、次要、三级、静默。每个服务不同的角色:默认文本、辅助文本、元数据和禁用/占位符。一致地使用所有四个。如果你只用两个,你的层级太扁平了。

边框递进

边框不是二元的。构建一个比例,将强度与重要性相匹配——标准分离、较柔和分离、强调、最大强调。并非每个边界都值得同样的权重。

控件Token

表单控件有特定需求。不要复用表面token——为控件背景、控件边框和焦点状态创建专用的token。这让你可以独立于布局表面来调整交互元素的性能。

间距

选择一个基础单位并坚持使用它的倍数。为不同上下文构建比例——图标间距的微间距、按钮和卡片内部的组件间距、分组之间的区块间距、不同区域之间的主要分隔。随机值意味着没有系统。

内边距

保持对称。如果一侧有一个值,其他方向应该匹配,除非内容自然需要不对称。

…

[为翻译而截断]

Individual skills in this repo

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

ulasalyesil/personal-website-v2

Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.

ulasalyesil/personal-website-v2

Conduct design interviews, generate five distinct UI variations in a temporary design lab, collect feedback, and produce implementation plans. Use when the user wants to explore UI design options, redesign existing components, or create new UI with multiple approaches to compare.

ulasalyesil/personal-website-v2

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, artifacts, posters, or applications (examples include websites, landing pages, dashboards, React components, HTML/CSS layouts, or when styling/beautifying any web UI). Generates creative, polished code and UI design that avoids generic AI aesthetics.

ulasalyesil/personal-website-v2

Design and implement microinteractions, motion design, transitions, and user feedback patterns. Use when adding polish to UI interactions, implementing loading states, or creating delightful user experiences.

ulasalyesil/personal-website-v2

Best practices and example-driven guidance for building SwiftUI views and components. Use when creating or refactoring SwiftUI UI, designing tab architecture with TabView, composing screens, or needing component-specific patterns and examples.

ulasalyesil/personal-website-v2

UI/UX design intelligence. 50 styles, 21 palettes, 50 font pairings, 20 charts, 9 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, mobile app, .html, .tsx, .vue, .svelte. Elements: button, modal, navbar, sidebar, card, table, form, chart. Styles: glassmorphism, claymorphism, minimalism, brutalism, neumorphism, bento grid, dark mode, responsive, skeuomorphism, flat design. Topics: color palette, accessibility, animation, layout, typography, font pairing, spacing, hover, shadow, gradient. Integrations: shadcn/ui MCP for component search and examples.

ulasalyesil/personal-website-v2

Conduct WCAG 2.2 accessibility audits with automated testing, manual verification, and remediation guidance. Use when auditing websites for accessibility, fixing WCAG violations, or implementing accessible design patterns.

ulasalyesil/personal-website-v2

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "check accessibility", "audit design", "review UX", or "check my site against best practices".

ulasalyesil/personal-website-v2

Enforces an opinionated UI baseline to prevent AI-generated interface slop.

ulasalyesil/personal-website-v2

Build modern, composable, and accessible React UI components following the components.build specification. Use when creating, reviewing, or refactoring component libraries, design systems, or any reusable UI components. Triggers on tasks involving component APIs, composition patterns, accessibility, styling systems, or TypeScript props.

ulasalyesil/personal-website-v2

Ship correct, complete metadata.

ulasalyesil/personal-website-v2

Survey any codebase as a senior advisor and produce prioritized, self-contained implementation plans for OTHER models/agents to execute. Strictly read-only on source code — never implements, fixes, or refactors anything itself. Use when asked to audit a codebase, find improvement opportunities (bugs, security, performance, test coverage, tech debt, migrations, DX), suggest features or where to take the project next (roadmap, product direction), or generate handoff plans for another agent to implement.

ulasalyesil/personal-website-v2

Defines the product's objects, relationships, states, and vocabulary independently of any interface — the most load-bearing layer

ulasalyesil/personal-website-v2

Maps domain concepts, terminology conflicts, and bounded contexts — produces a noun harvest for the conceptual model layer

ulasalyesil/personal-website-v2

Maps interaction structure and flow — produces breadboard notation with edge cases, failure paths, and open decisions

ulasalyesil/personal-website-v2

Framework orientation for Layers of Product Design — load this first; provides the context all other skills depend on

ulasalyesil/personal-website-v2

User research planning and synthesis at the observed behaviour layer — produces candidate job stories with confidence ratings

ulasalyesil/personal-website-v2

Diagnostic audit across all seven layers — identifies the bottleneck layer and recommends where to focus

ulasalyesil/personal-website-v2

Connects user opportunities to business outcomes and solution bets — produces a strategy tree and prioritised experiments

ulasalyesil/personal-website-v2

Audits existing surface against lower-layer decisions and produces a surface decision inventory — vocabulary, object consistency, completeness, feedback, hierarchy, accessibility

相关技能