前端界面设计
Design前端界面设计 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。
How to use this skill
Bring this guide into your coding agent with a prompt tailored to the tool you use.
- Open your project in Codex.
- Copy and paste the prompt below.
- Review files and risks before approving any action.
Inspect the Agent Skill at https://github.com/maka-agent/maka-agent/blob/HEAD/apps/desktop/resources/bundled-skills/frontend-design/SKILL.md and all supporting files. Report provenance, permissions, scripts, dependencies, and security risks. Propose an exact installation into .agents/skills/前端界面设计, but wait for my approval before writing files or running scripts.
Copying this prompt does not install or run the skill. Review third-party files before use.
前端界面设计
目标
生成有设计品味、不带 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 基准)。
- 圆角、线宽、强调色、某个重复形状——挑几个签名元素在全页重复,建立识别度。
输出格式
- 先用一两句说明你的设计判断:风格方向、选定的字体与配色(给出具体 hex)、布局结构。
- 用 Write 写出单文件 HTML 到用户指定路径或
<描述性名字>.html(放当前目录)。文件必须自包含:<style>内联全部 CSS,字体用<link>引 Google Fonts,交互 JS 内联在<script>。语义化 HTML、含<meta name="viewport">、窄屏回落单列。 - 用 Bash 打开预览:macOS 用
open <文件路径>。 - 简述做了什么、有哪些设计决策值得注意,并说明如何进一步调整。
边界
- 只产出自包含单文件 HTML/CSS/JS,不引入构建工具、不拆分多文件、不依赖本地不存在的资源。
- 不做后端、不接真实 API;需要数据时用可信的假数据填充。
- 若用户要 React/Vue 组件源码而非可预览页面,如实产出组件代码即可,设计原则同样适用;但默认交付物是能直接打开看的 HTML。
- 内容语言默认跟随用户 prompt 的语言,保留其中的英文术语原样。