izittmarvin/nova-agent/nova-frontend

nova-frontend — 技术精湛 · 灵魂鲜明 · 从不廉价

一个把"防 AI slop"做到极致的前端设计技能。融合三套生产级方法论：先读懂 brief，

定 register 与 dial，再按需加载深层 reference。目标是产出一眼看不出是 AI 套模板的界面。

核心机制：本技能的深层规则拆分在 <%= skillDirectory %>/references/ 下。

SKILL.md 只是路由表 + 常驻底线。每个阶段只用 `read` 工具读取当下需要的那一个 reference 文件，

不要一次性全读进来。所有规则都是上下文相关的——先读 brief，再挑适用的拉进来。

一套方法对所有 brief 产出同一个页面，就是失败。

如何使用（执行顺序）

1. §0 读懂 brief：判定 register（brand / product / commerce）与灵魂方向，输出一行 Design Read。
2. §1 定三个 dial：SOUL / SPECTACLE / DENSITY，从 brief 推断，不要默默用基线。
3. 两条路都要：铺 §3 的 premium substrate（读 design-dna.md）——这层物理质感让 dashboard 也不廉价。
4. 分流：

• brand → 挑一个灵魂（style-personas.md）+ 造一个 hero 引擎（motion-engines.md）。
• product → 组件系统 + 数据密度（product-ui.md）。
• commerce → PDP/PLP 骨架 + 反暗黑模式（commerce-ui.md）。

1. 组装页面，动效必须被动机驱动。
2. 发布前跑 §6 反廉价扫描（anti-cheap.md）+ 完整 pre-flight（preflight.md）。

Reference 路由表（用 read 按需加载，路径前缀 <%= skillDirectory %>/references/）

§0 读懂 Brief（先于一切）

多数 AI 设计之所以差，是因为模型跳过读题、直接套一个默认审美。别这样。

0.A 判定 register（这一步分流后面所有决策）

• brand — 设计就是产品：landing page、品牌站、发布页、作品集、hero 页。要大胆、有观点、有奇观。走灵魂 + hero 引擎路线。
• product — 设计服务于产品：dashboard、admin、分析、数据表、app 外壳、设置。为清晰 / 密度 / 可用性优化。走组件系统路线。仍然从不廉价（继承 substrate + 反廉价黑名单）。
• commerce — 混合态：按具体页面的任务分流：卖单个 hero 商品的 PDP 偏 brand（挑灵魂但保持规格/评价/信任信号的高密度）；多 SKU 的 PLP/市场偏 product（高密度、低 spectacle）。拿不准就问一句："这页是卖一个产品的氛围，还是帮人比较筛选很多个？"

先读项目记忆：若项目根有 PRODUCT.md / DESIGN.md，先读，它覆盖你的猜测。已有品牌色/字体时——身份保留优先，reflex-reject 列表只对全新决策生效。

0.B 生成一行 Design Read（写代码前必出）

格式：Design Read: {行业} · {2-3词灵魂} · register={brand|product|commerce} · SPECTACLE={n} · hero-engine={类型}

例：Design Read: 深空天文 · 电影感+庄严 · register=brand · SPECTACLE=8 · hero-engine=Three.js 粒子星系

输出 Design Read 后先停，等用户确认方向或纠偏，再进 §1。 除非用户已明确说"直接做"。

0.C brief 模糊时，只问一个问题，别瞎猜

一个尖锐的问题胜过五轮错误默认。问那个最能改变产出的："这该偏克制编辑感，还是极致奇观？" / "离开 10 秒后你希望访客记住什么？"问完等答案。

0.D Anti-Default 纪律（最常被考的 AI tell）

先说出这个 brief 的懒惰默认，再打败它："咖啡品牌 → 默认是暖米色 + 黄铜衬线。我拒绝它，改用 {x}，因为 {理由}。" 两个高度都要查：一阶（能从行业本身猜出主题+配色吗？"AI SaaS → 紫色辉光 + Inter"）；二阶（能从行业+你的反参照猜出吗？"不做 SaaS 米色的 AI 工具 → 编辑体排版"）。两个答案都不明显才算过。完整 reflex 列表见 anti-cheap.md §0。

§1 三个 Dial

从 Design Read 明确设定，别默默用基线。它们驱动下游一切。

快速预设（有更强信号立刻覆盖）：landing(无其他线索) SOUL7/SPEC6/DEN4 · agency/creative landing 8/8/3 · 高端消费 8/5/3 · portfolio 8/6/3 · editorial 8/4/6 · tech/AI/SaaS 营销 6/7/5 · B2B/企业 4/3/6 · dashboard/analytics（product）4/2/9 · PDP 6/4/6 · PLP 3/2/8 · public-sector/信任优先 3/2/5。

"SPECTACLE 声称即兑现"（强制）：若 SPECTACLE ≥ 7，页面必须真有一个能跑的视觉引擎（真实 Three.js/Canvas/GLSL/滚动钉住），能优雅降级，中端设备维持 60fps。声称 8 却发一个渐变色块 = 破损。做不出就把 dial 降到 4，发一个打磨到位的静态页。永远别半吊子做个会卡/断裂的引擎。

常驻底线（即使不读任何 reference 也必须遵守）

这些是三套方法论里最高频、最致命的 tell。下面每一条都是发布阻断项，完整清单在 anti-cheap.md：

1. Em-dash（`—`）完全禁用——标题、eyebrow、pill、正文、引用、署名、按钮、alt 文本，一个都不许有。这是 #1 AI tell。用句号、逗号或重构句子。en-dash（–）当分隔符同禁；范围用连字符（2018-2026、€40-80k）。
2. 禁 div 假截图——不用 <div> 拼假 dashboard/假任务列表/假终端。用真截图、生成图、真组件预览，或干脆不放。
3. 禁渐变文字（background-clip:text + gradient）作默认花活。用单色，靠字重/字号强调。
4. 禁 AI 紫/蓝辉光——紫色渐变按钮、霓虹网格背景、发光 CTA 作默认。用中性底 + 一个高对比强调色。#6366f1（通用靛蓝）是 AI UI 最被滥用的 hex，别默认伸手。
5. 禁假精确数字——92%、4.1×、5.8mm 之类为凑规格感编造的。要么有真实来源，要么标注 mock，要么删掉。
6. eyebrow 限量——标题上方那个小号大写宽字距标签，每 3 个 section 最多 1 个（hero 算 1 个）。机械检查：数 uppercase tracking 小标签数量，超过 ceil(sectionCount/3) 就失败。
7. 禁纯 `#fff`/`#000`、硬 #333 边框、亮底上的纯黑投影。用向品牌色微调的中性色、半透明边框、带色相的投影。
8. 一个强调色锁全页——暖灰站不能在第 7 节冒出蓝色 CTA。选定即锁死，发布前逐组件审。
9. 禁默认品类配色——craft/heritage 的米色+黄铜、AI/SaaS 的紫辉光——先命名、再拒绝。
10. 图片隐含的 brief 必须有真图（餐厅/酒店/时尚/旅行/食品/产品）——零图片是 bug 不是极简。纯文本 + 渐变色块不是 hero。

命令（可选精确入口；自然语言也会触发）

首词匹配命令则按该命令流程走；不匹配但意图清晰也路由过去；无参数则推荐 2-3 个最高价值命令让用户确认，别自动跑。

发布前

说"完成"之前，必须跑 anti-cheap.md 的反廉价扫描 + preflight.md 的完整检查清单。任一硬规则不过 = 发的是破损的活，先修再交付。