Skip to content

Frontend UI Engineering 解决的是 AI 生成前端页面“能渲染但不像产品”的问题。它要求按项目已有设计系统写组件,处理状态、响应式、键盘操作、可访问性和真实浏览器验证。

AI 写前端页面为什么总有模板味:Frontend UI Engineering 怎么用

下载 frontend-ui-engineering 中文版 Skill ZIP

页面一渲染出来,又是紫色渐变和一排圆角卡片。

阴影很多,按钮很大,文案像模板,和项目里原来的界面完全接不上。

这类页面能跑,但不像你的产品。

frontend-ui-engineering 这个技能要解决的就是这个问题:前端不是把组件堆出来,而是要符合项目设计、用户路径和真实运行状态。

先看项目已有 UI

让 AI 写页面前,先让它看现有组件和页面。

不要让它凭默认审美创建新风格。

你可以要求:

md
先查看项目已有页面和组件风格。
复用现有按钮、卡片、表单、颜色和间距规则。
不要引入新的视觉风格,不要使用默认的紫色渐变和大阴影。

AI 默认喜欢“安全好看”的模板,但站点或产品需要一致性。

真实内容比占位文字重要

前端页面用 lorem ipsum 很容易掩盖问题。

真实标题会换行,真实用户名长度不一,真实错误信息可能很长,真实列表可能为空。

让 AI 写 UI 时,要让它考虑这些状态:

  • 加载中。
  • 空状态。
  • 错误状态。
  • 数据很多。
  • 文案很长。
  • 移动端宽度。

只有 happy path 的页面,不能算完成。

可访问性不是装饰

AI 写 UI 时常见错误是把 div 当按钮,把图标按钮不加标签,弹窗打开后焦点乱跑。

审查时要看:

  • 交互元素能不能用键盘操作。
  • 表单输入有没有 label。
  • 图标按钮有没有可读名称。
  • 错误信息是否和输入框关联。
  • 颜色是否有足够对比度。
  • 页面标题层级是否合理。

这些不是只给少数用户准备。键盘、读屏、焦点管理做得好,普通用户也会觉得页面更稳。

组件不要过度配置

AI 很容易写一个万能组件,塞很多 props:variant、size、layout、headerMode、footerMode、showX、enableY。

这种组件看起来灵活,实际很难维护。

更好的方式是组合:

  • 小组件职责清楚。
  • 数据获取和展示分开。
  • 状态逻辑不要塞进纯展示组件。
  • 一次只抽取已经重复出现的模式。

前端代码最怕“为未来设计”。如果未来没来,复杂度会一直留在项目里。

写完一定要看浏览器

前端不能只靠类型检查和单元测试。

按钮位置、响应式、滚动、弹窗、焦点、接口请求,这些都要在浏览器里看。

如果是 Claude Code 这类工具,最好配合浏览器测试能力,让 Agent 截图、看 console、看 network。没有浏览器验证,就至少手动走一遍关键路径。

给 AI 的前端 Prompt

md
请按生产 UI 标准实现这个页面。
要求:
1. 先查看项目已有组件和样式,不要创造新视觉体系。
2. 覆盖加载、空状态、错误状态和移动端布局。
3. 交互元素必须可键盘操作,表单必须有 label。
4. 不要使用模板化紫色渐变、大阴影和无意义卡片堆叠。
5. 完成后说明如何在浏览器里验证。

你可能还需要

同类技能:

如果页面是给用户看的,就不要只问 AI 有没有编译通过。打开浏览器看。