让 Codex 设计前端不丑:Skill、参考站点与重开发流程
整理了一个仓库:https://github.com/aihes/frontend-design-learning.git
这份手册整理这轮实验里所有关键原则:不同前端设计 Skill 的底层原理、这类外部设计工具的价值、参考库如何用、以及最重要的一步:让 Codex 先找类似站点,抽象设计语言,再重新开发。
一句话结论:Codex 不应该被当成独立设计师,而应该被当成有浏览器和工程能力的前端实现者。设计方向要由 Skill、参考站点、设计系统和截图 QA 共同约束。
为什么 Codex 直接设计会丑
Codex 直接收到“做一个好看的页面”时,通常会走向平均值:
居中大标题。 三列卡片。 紫蓝渐变。 默认字体。 大面积圆角卡片。 文案像模板。 只做桌面成功态,不做移动端、空状态、加载态、错误态。
这不是单个模型的问题,而是 prompt 过于空泛。模型没有真实设计目标、参考图、品牌约束和验收标准,只能回到训练集中最常见的 UI 形态。
所以正确做法不是继续说“再高级一点”,而是把设计问题拆开。
前端设计的六层问题
interactive-portfolio | |||
design-consultation | |||
design-shotgun | |||
tailwind-design-system | |||
shadcn-layouts | |||
claude-page-review |
只改 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 设计/生成工具
这类工具的正确定位:不是生产依赖,而是参考输入和人工设计辅助。
参考库
参考库比 AI 生成器更稳定。对于 Codex,它们的价值是提供“真实世界的设计样本”,让 Codex 不要凭空想象。
3. Codex 先找类似站点,再重开发
这是最重要的工作流。
不要让 Codex 直接回答:
帮我做一个好看的简历网站。
应该让 Codex 先做参考研究:
先找 5 个同类高质量站点,截图首屏和关键 section,分析它们的信息架构、视觉语言、字体、颜色、组件、动效和移动端布局。不要抄袭,只抽象设计原则。然后基于这些原则重新设计并实现一个新页面。
具体步骤
明确页面类型
例如:候选人个人网站、SaaS landing page、报告页、AI copilot、dashboard、编辑器。找参考来源
视觉方向用 Variant/Godly/Land-book/Awwwards。真实产品流程用 Mobbin/Page Flows/Refero。SaaS 产品页用 Saaspo/Land-book。截图并归档
至少保存桌面首屏、关键 section、移动端首屏。没有截图,就没有设计参考。抽象而不是复制
抽象这些信息:
信息顺序。 字体气质。 色彩关系。 留白密度。 CTA 层级。 卡片/列表/时间线/作品展示模式。 移动端折叠方式。 动效节奏。
生成设计 brief
把参考站点的共性变成可执行 brief,不要说“像某某网站”,而是说:
左对齐 editorial hero。 单一强调色。 项目区用案例研究卡,不用普通三列 feature card。 首屏露出下一屏内容。 移动端 CTA 全宽。 不使用假 logo 和推荐语。
Codex 实现
Codex 根据 brief、设计 token 和组件规则写代码。Playwright QA
打开真实页面,截桌面和移动端,检查:
文本是否溢出。 CTA 是否可见。 图片是否加载。 滚动是否正确。 移动端是否一列且没有横向滚动。 动效是否影响性能。
二次审查
用claude-page-review或人工审查检查:文案、可信度、隐私、夸大、品牌一致性。
4. Codex 前端设计 Prompt 模板
参考研究 Prompt
我要做一个 [页面类型],目标用户是 [用户],核心目标是 [目标]。
请先不要写代码。先搜索/打开 5 个高质量同类站点作为参考,保存截图,并从这些维度分析:
1. 首屏信息结构
2. 导航和 CTA
3. 字体气质
4. 色彩系统
5. section 顺序
6. 卡片/列表/图像使用方式
7. 移动端布局
8. 哪些设计可以抽象,哪些不能复制
最后输出一个新的设计 brief,再基于 brief 重新设计,不要直接抄任何站点。
实现 Prompt
基于刚才的设计 brief 实现页面。
要求:
- 使用现有项目的真实源码入口,不改构建产物。
- 使用现有组件和 t…