# 前端界面设计

> 前端界面设计 is an Agent Skill for design published in the maka-agent/maka-agent repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

当用户需要生成有设计品味的 web 页面、落地页、dashboard、组件或对现有 UI 做美化重构时使用。典型问法："帮我做一个 XX 页面"、"设计一个落地页"、"这个界面太丑帮我重做"、"给我一个有质感的组件"。产出自包含的单文件 HTML。

- Skill name: `前端界面设计`
- Category: [Design](https://www.openparable.com/skill/design/1)
- Source: https://github.com/maka-agent/maka-agent/blob/HEAD/apps/desktop/resources/bundled-skills/frontend-design/SKILL.md
- Repository: maka-agent/maka-agent (675 GitHub stars when collected)

## SKILL.md

# 前端界面设计

## 目标

生成**有设计品味、不带 AI 味儿**的 web 界面：页面、落地页、dashboard、组件。产物是一个自包含的单文件 HTML（CSS 内联在 `<style>`，必要的 JS 内联在 `<script>`，字体用 Google Fonts 链接或系统栈），用浏览器直接打开即可预览。

核心判断标准：把结果放到真实产品里不会显得"像 AI 随手生成的模板"。绝大多数平庸 UI 的问题不是"不能用"，而是**层次含糊、配色发怵、排版没有主张、细节经不起放大**。这个 skill 的任务就是把这些抹平，做出经得起设计师审视的界面。

## 工作流步骤

### 1. 明确用途与主任务

先想清楚这个界面**为谁、解决什么、主操作是什么**。每个屏幕只回答一个主导问题、支持一个主操作。多个目标竞争时，拆成不同区域或不同页面，绝不堆在一屏。

- 是营销页（landing / 官网）还是功能界面（dashboard / 工具 / 表单）？两者规则不同：营销页追求视觉叙事与冲击力，功能界面追求信息效率与自解释。
- 目标用户是谁、在什么设备上看、深色还是浅色为主。
- 列出必须出现的内容块，按重要性排序——这个顺序决定视觉层次。

### 2. 定基调：风格方向与设计变量

在动手前先声明三个变量，写进你的推理，用它们驱动所有决策：

- **视觉变异度**（1=完美对称，10=艺术化混乱）：默认 6-7。> 4 时禁止居中式 Hero，改用 split screen（50/50）、左文右图、非对称留白。
- **动效强度**（1=静止，10=电影级）：默认 4-6，只做 hover/active 过渡与入场微动画，不做喧宾夺主的滚动特效。
- **信息密度**（1=画廊留白，10=驾驶舱堆料）：功能界面 4-6，营销页 3-4，数据密集看板 7+。

### 3. 排版（Typography）

排版是"高级感"最大的来源。

- **字体选择**：追求品质感/创意感时**避开 Inter**（AI 味儿的重灾区），优先 `Geist`、`Outfit`、`Satoshi`、`Cabinet Grotesk`、`Sora`、`Space Grotesk` 这类有个性的 sans-serif。技术类 dashboard 严禁 serif，用高级 sans + 等宽（`Geist Mono` / `JetBrains Mono`）搭配数字。serif 只用于编辑类/文艺类页面。
- **最多 2 个字族**，靠 weight 和 size 拉层次，不靠换字体。
- **标题**：大号、bold、字距收紧（-1% 到 -3%）、行高压紧（0.95-1.1）。
- **正文**：中性灰、行高松（1.4-1.6）、单行宽度 ≤ 65 字符（英文）保证可读。
- **层次不能只靠字号砸大**，要 weight + 颜色对比 + 间距三者配合。避免巨大到失控的 H1。

### 4. 配色（Color）

- **最多 1 个强调色**，饱和度 < 80%。
- **严禁"AI 紫/AI 蓝"**：不要紫色按钮光晕、不要霓虹渐变。用绝对中性底（Zinc / Slate / Neutral 灰阶）配单一高对比强调色（Emerald、Electric Blue、Deep Rose、Amber 等），并把强调色适当去饱和让它融进中性里。
- **不用纯黑 `#000000`**：用 off-black、`Zinc-950`、带底色色相的近黑（如导航蓝底上用 `#0A0E1A`）。
- **整个设计只用一套灰阶**：不要冷灰暖灰在同一页乱跳。
- 正文与背景对比 ≥ 4.5:1，重要文字 ≥ 7:1。
- 渐变算作一个颜色角色，不要滥用文字填充渐变。

### 5. 布局与层次（Layout）

- **每屏一个主导区域**：视觉重量必须反映重要性，次要区域明显从属，避免等权布局与多个焦点打架。
- **反居中偏见**：变异度 > 4 时把 Hero 换成 split / 左对齐内容 + 右侧素材 / 非对称留白。
- **用 CSS Grid** 搭列结构，比复杂百分比计算更可靠。页面用 max-width（约 1200-1400px）居中收口，别让内容拉满超宽屏。
- **禁止"三等分卡片"** 这种最典型的 AI 特征行。改用 2 列 zig-zag、非对称网格、bento grid（大小不一的瓷砖式分组，Apple Control Center 风格）或横向滚动。
- 留白是设计元素不是剩余空间：让负空间有形状。
- 卡片只在"抬升代表层级"时才用；用阴影时把阴影染上背景色相，做很淡、扩散大的"漫射阴影"，不要默认外发光。密集数据看板里少用卡片盒子，改用分隔线和留白分组。

### 6. 状态与微交互

即使是静态展示页也要考虑完整交互周期：

- **Loading**：用匹配布局尺寸的 skeleton（骨架屏 + shimmer），不用通用转圈。
- **空状态 / 错误状态**：认真设计，空状态要引导如何填充数据；表单错误就近内联提示（label 在输入框上方，错误文字在下方）。
- **触感反馈**：active 态做细微 scale/translate 模拟按下；hover 过渡自然（150-250ms，`ease-out`）。
- 玻璃拟态要做真的：blur 之上加 1px 内边框（白 ~10%）+ 内阴影模拟边缘折射，不是单纯模糊。

## 避免 AI 味儿清单（生成后逐条自查）

- 有没有用 Inter 当主字体、有没有 AI 紫/霓虹渐变、有没有纯黑 → 有就换。
- 有没有三等分等宽卡片、有没有居中 Hero 大标题 + 副标题的老套结构 → 有就重排。
- 假数据别用 "John Doe" / "Sarah Chen" / "Acme" / "Nexus" / "99.99%" / "50%"——用可信的真实感名字、有机数字（`47.2%`、`+1 (312) 847-1928`）、有语境的品牌名。
- 别用 "Elevate / Seamless / Unleash / Next-Gen" 这类填充词，用具体的动词和名词。
- 图片占位用可靠源：`https://picsum.photos/seed/<随机串>/800/600`，别用会挂的 Unsplash 直链。
- 对齐与间距要数学级精确，用一致的间距刻度（4/8px 基准）。
- 圆角、线宽、强调色、某个重复形状——挑几个签名元素在全页重复，建立识别度。

## 输出格式

1. 先用一两句说明你的设计判断：风格方向、选定的字体与配色（给出具体 hex）、布局结构。
2. 用 **Write** 写出单文件 HTML 到用户指定路径或 `<描述性名字>.html`（放当前目录）。文件必须自包含：`<style>` 内联全部 CSS，字体用 `<link>` 引 Google Fonts，交互 JS 内联在 `<script>`。语义化 HTML、含 `<meta name="viewport">`、窄屏回落单列。
3. 用 **Bash** 打开预览：macOS 用 `open <文件路径>`。
4. 简述做了什么、有哪些设计决策值得注意，并说明如何进一步调整。

## 边界

- 只产出**自包含单文件 HTML/CSS/JS**，不引入构建工具、不拆分多文件、不依赖本地不存在的资源。
- 不做后端、不接真实 API；需要数据时用可信的假数据填充。
- 若用户要 React/Vue 组件源码而非可预览页面，如实产出组件代码即可，设计原则同样适用；但默认交付物是能直接打开看的 HTML。
- 内容语言默认跟随用户 prompt 的语言，保留其中的英文术语原样。

---

Source: https://www.openparable.com/skill/design/%E5%89%8D%E7%AB%AF%E7%95%8C%E9%9D%A2%E8%AE%BE%E8%AE%A1 (OpenParable). Cite the canonical URL above.
