让 Codex 设计前端不丑:Skill、参考站点与重开发流程

整理了一个仓库:https://github.com/aihes/frontend-design-learning.git

这份手册整理这轮实验里所有关键原则:不同前端设计 Skill 的底层原理、这类外部设计工具的价值、参考库如何用、以及最重要的一步:让 Codex 先找类似站点,抽象设计语言,再重新开发。


一句话结论:Codex 不应该被当成独立设计师,而应该被当成有浏览器和工程能力的前端实现者。设计方向要由 Skill、参考站点、设计系统和截图 QA 共同约束。

为什么 Codex 直接设计会丑

Codex 直接收到“做一个好看的页面”时,通常会走向平均值:

  • 居中大标题。
  • 三列卡片。
  • 紫蓝渐变。
  • 默认字体。
  • 大面积圆角卡片。
  • 文案像模板。
  • 只做桌面成功态,不做移动端、空状态、加载态、错误态。

这不是单个模型的问题,而是 prompt 过于空泛。模型没有真实设计目标、参考图、品牌约束和验收标准,只能回到训练集中最常见的 UI 形态。

所以正确做法不是继续说“再高级一点”,而是把设计问题拆开。

前端设计的六层问题

层级
要解决的问题
典型工具/Skill
验收标准
叙事层
这个页面到底要表达什么
interactive-portfolio
30 秒内知道是谁、做什么、最强证明、如何联系
信息架构层
页面有哪些模块,先后顺序是什么
Relume、design-consultation
模块顺序支持用户决策,不堆字段
视觉方向层
页面看起来像哪类产品/品牌
Variant、Godly、Land-book、design-shotgun
有明确视觉立场,不像通用模板
设计系统层
颜色、字体、间距、组件如何复用
tailwind-design-system
token 和组件统一,不散落硬编码
布局工程层
页面是否稳定、可滚动、响应式
shadcn-layouts
桌面/移动端都不崩,滚动区域正确
发布审查层
是否可信、不过界、没有隐私问题
claude-page-review
、Playwright
不编造,不泄露,截图检查通过

只改 CSS,最多解决第三层的一部分。真正好看的前端,通常是六层都处理过。

1. Skill 的内部原理

interactive-portfolio

底层原理:作品集不是简历网页化,而是一次机会转化。

它最适合个人网站、作品集、简历站。核心是 30 秒测试:

  • 你是谁?
  • 你做什么?
  • 你最强的证明是什么?
  • 我怎么联系你?

它要求项目优先于经历堆叠。项目不是列表,而是证据:问题、角色、过程、关键决策、结果、链接。

对 Offer-Compass 来说,interactive-portfolio 应该放在最前面,用来把简历从时间顺序改成证明顺序。

frontend-design

底层原理:先决定视觉立场,再写代码。

它会逼 Codex 先选一个明确方向:编辑感、极简、工业风、奢华、玩具感、产品档案、战报、控制台。字体、颜色、背景、动效、空间都必须服务这个方向。

它解决的是“不要像普通 AI 模板”。

design-taste-frontend

底层原理:LLM 生成 UI 有统计偏差,要用规则反向校准。

它会禁止或限制常见 AI 味:

  • 紫蓝渐变。
  • Inter/Arial/system 默认字体。
  • 三列等宽卡片。
  • 每段都套 card。
  • 过强阴影和荧光。
  • 只做成功态。
  • 移动端高度和滚动没处理。

它像前端审美和工程质量 gate。

design-shotgun

底层原理:早期不要在一个错误方向上微调,要先扩大搜索空间。

它适合一次生成多个真正不同的视觉方向。不是换按钮颜色,而是改信息结构、视觉密度、字体、页面节奏和情绪。

当用户说“不好看”“不是这个感觉”时,通常应该回到 design-shotgun,而不是继续局部调 CSS。

design-consultation

底层原理:设计不是单页,而是一套可复用选择。

它适合定义模板家族、品牌气质、颜色系统、字体系统、间距节奏、模块规则。对于“上传简历生成个人网站”这种产品,它比一次性页面更重要。

tailwind-design-system

底层原理:设计判断必须变成 token 和组件契约。

颜色、字体、间距、圆角、阴影、按钮、卡片、标签,都应该有单一事实源。否则每个生成页都会漂。

shadcn-layouts

底层原理:CSS 布局来自约束链。

它解决的是页面会不会坏:

  • h-full 有没有父级高度。
  • flex 滚动子元素有没有 min-h-0。
  • grid 子项有没有 grid 父级。
  • ScrollArea 有没有明确高度。
  • 侧栏、顶部栏、主内容区的 shrink/overflow 是否正确。

frontend-css-patterns

底层原理:视觉语言由可复用 CSS 模式构成。

它补的是表达力:字体搭配、有限配色、错位构图、重叠、纹理、渐变、遮罩、动效节奏。它应该服务内容,不应该堆效果。

landing-page-design

底层原理:页面服务转化。

首屏 5 秒要说清楚价值、证据和行动。它适合 Offer-Compass 的获客页、报告页、咨询预约页,但不应该直接套到候选人主页上,否则容易像销售页。

claude-page-review

底层原理:Codex 控流程,Claude 做页面二次审查。

它适合上线前检查:

  • 首屏是否清楚。
  • 文案是否给用户看。
  • 是否编造事实。
  • 是否暴露隐私。
  • 是否过度设计。

2. 外部站点怎么用

这次已经归档的截图包括:

  • assets/variant-home.png:Variant 首页,用来理解 AI 视觉探索工具的产品表达。
  • assets/relume-generated-wireframe.png:Relume 生成的 sitemap/wireframe,用来理解信息架构和线框价值。
  • assets/godly-home.png:Godly 首页,用来找高审美网站方向。
  • assets/land-book-home.png:Land-book 首页,用来找 landing page 和 section 参考。
  • assets/original-interactive-portfolio.png:interactive-portfolio 方向的简历站效果。
  • assets/playbook-desktop.png、assets/playbook-mobile.png:本手册页面的桌面/移动端验证截图。

AI 设计/生成工具

网站
类型
我们实测结果
最适合用途
Variant
AI 视觉探索
可打开,可输入 prompt,提交需登录
找多种视觉方向
Figma Make
AI web design
可打开,可输入 prompt,提交需登录
Figma 内生成/调整设计
v0
AI app/code generator
可输入 prompt,生成私有 chat,预览需登录态
登录后做代码生成
Lovable
AI app builder
可输入 prompt,提交需账号
应用原型生成
Bolt
AI app builder
可输入 prompt,提交需登录
应用原型生成
Relume
sitemap/wireframe
未登录生成 sitemap + wireframe
信息架构和线框
Uizard
AI UI generator
生成器需登录
UI mockup
Visily
AI UI generator
生成器需登录
UI mockup / screenshot to design
Subframe
code-first UI design
builder 需登录
设计系统和 code-first UI

这类工具的正确定位:不是生产依赖,而是参考输入和人工设计辅助。

参考库

网站
价值
适合找什么
Godly
高审美网站灵感
强视觉、反模板、作品集、AI 产品页
Land-book
网站/landing page 灵感
首屏、section、品牌页
Saaspo
SaaS 网站参考
产品页、报告页、功能页
Awwwards
创意网站奖项
高冲击、实验性、视觉方向
Mobbin
真实产品 UI 截图
登录、上传、编辑、分享、dashboard
Page Flows
用户流程
onboarding、checkout、upload、search
Refero
Web/iOS UI 参考
页面模式和组件细节

参考库比 AI 生成器更稳定。对于 Codex,它们的价值是提供“真实世界的设计样本”,让 Codex 不要凭空想象。

3. Codex 先找类似站点,再重开发

这是最重要的工作流。

不要让 Codex 直接回答:

帮我做一个好看的简历网站。

应该让 Codex 先做参考研究:

先找 5 个同类高质量站点,截图首屏和关键 section,分析它们的信息架构、视觉语言、字体、颜色、组件、动效和移动端布局。不要抄袭,只抽象设计原则。然后基于这些原则重新设计并实现一个新页面。

具体步骤

  1. 明确页面类型
    例如:候选人个人网站、SaaS landing page、报告页、AI copilot、dashboard、编辑器。

  2. 找参考来源
    视觉方向用 Variant/Godly/Land-book/Awwwards。真实产品流程用 Mobbin/Page Flows/Refero。SaaS 产品页用 Saaspo/Land-book。

  3. 截图并归档
    至少保存桌面首屏、关键 section、移动端首屏。没有截图,就没有设计参考。

  4. 抽象而不是复制
    抽象这些信息:

  • 信息顺序。
  • 字体气质。
  • 色彩关系。
  • 留白密度。
  • CTA 层级。
  • 卡片/列表/时间线/作品展示模式。
  • 移动端折叠方式。
  • 动效节奏。
  1. 生成设计 brief
    把参考站点的共性变成可执行 brief,不要说“像某某网站”,而是说:
  • 左对齐 editorial hero。
  • 单一强调色。
  • 项目区用案例研究卡,不用普通三列 feature card。
  • 首屏露出下一屏内容。
  • 移动端 CTA 全宽。
  • 不使用假 logo 和推荐语。
  1. Codex 实现
    Codex 根据 brief、设计 token 和组件规则写代码。

  2. Playwright QA
    打开真实页面,截桌面和移动端,检查:

  • 文本是否溢出。
  • CTA 是否可见。
  • 图片是否加载。
  • 滚动是否正确。
  • 移动端是否一列且没有横向滚动。
  • 动效是否影响性能。
  1. 二次审查
    用 claude-page-review 或人工审查检查:文案、可信度、隐私、夸大、品牌一致性。

4. Codex 前端设计 Prompt 模板

参考研究 Prompt

我要做一个 [页面类型],目标用户是 [用户],核心目标是 [目标]。

请先不要写代码。先搜索/打开 5 个高质量同类站点作为参考,保存截图,并从这些维度分析:
1. 首屏信息结构
2. 导航和 CTA
3. 字体气质
4. 色彩系统
5. section 顺序
6. 卡片/列表/图像使用方式
7. 移动端布局
8. 哪些设计可以抽象,哪些不能复制

最后输出一个新的设计 brief,再基于 brief 重新设计,不要直接抄任何站点。

实现 Prompt

基于刚才的设计 brief 实现页面。

要求:
- 使用现有项目的真实源码入口,不改构建产物。
- 使用现有组件和 t…
— 以上为试看内容(约 40%),开通会员后阅读全文 —