防 AI 模板味品味规范

把「好品味」写成 AI 真正听得懂的工程守则。结合 VibeCheck 的前端审计规则与真实设计规范,一键放进 Claude Code、Cursor、Codex 或 Antigravity。

代理写代码前先对齐的十件事

01no-slop-copy

拒绝套话主标题与 ✨ 胶囊徽章

首屏严禁堆砌「一站式智能赋能」「重塑工作流」「Supercharge with AI」与 ✨ 🚀 药丸标签。第一屏必须直接点明产品动作、输入输出与目标人群。

02disciplined-palette

90% 中性底色 + 单一语义强调色

画布与表面保持干净低噪(深色如 #09090b / #111113,浅色如 #fafafa / #ffffff),禁止蓝紫霓虹渐变标题字与大面积发光晕染;主按钮用高对比墨色。

03typography-measure

排版尺度、tabular-nums 与中英回退栈

大标题紧字距(-0.03em ~ -0.045em)配 text-wrap: balance;正文行宽控制在 60–68ch;所有比分、价格、指标一律开启 font-variant-numeric: tabular-nums。

04asymmetric-rhythm

用细线台账与真界面样本取代三等分卡片

打破「居中标题 + 三张一模一样的带圈图标卡片」生成器定式,改用 1px 细线台账(Hairline Ledger)、非对称双栏或真实可交互的界面局部。

05no-fake-proof

零假数据、零随机头像墙

严禁使用 pravatar.cc / randomuser.me 假头像、虚构客户 Logo 跑马灯或「10万+ 用户、99.9% 准确率」无出处整十数字。

06clear-cta

主行动按钮写清动作结果

首屏只保留 1 个最高权重主按钮,用「连接 GitHub 仓库」「检测公开网址」取代去向不明的「立即体验 / Get Started / Learn More」。

07compositor-motion

严禁 transition-all,动画只走合成层

显式声明 transition-[color,background-color,border-color,transform,opacity],微交互控制在 140–240ms,并按规则粒度尊重 prefers-reduced-motion。

08copy-ux

可访问的复制反馈与键盘可达性

复制按钮在显示「已复制」期间绝不设置 disabled(避免丢失键盘焦点),使用网格叠放固定宽度并通过按钮外的 role="status" 播报状态。

09layout-resilience

双视口零横向溢出与 min-width: 0

承载 URL、代码或长译文的 Flex/Grid 子项必须设置 min-w-0;禁用 100vw 造全宽,交付前在 1440×900 与 390×844 双视口实测。

10ship-hygiene

上线前补齐元数据与安全基线

核对真实唯一 Title、Meta Description、Canonical、1200×630 OG 图、JSON-LD 结构化数据,确保前端包零私钥泄漏。

选择你的编码工具,复制或下载规范文件

你还可以从下拉框任选一个已收录的标杆网站(如 Linear、Resend、Zed、Emil Kowalski),将它的实测配色与字体直接写入导出的 SKILL.md。

放置路径:.claude/skills/vibecheck-taste/SKILL.md (Claude Code · Codex · Antigravity)
---
name: vibecheck-taste-guardrails
description: 编写或重构前端落地页、SaaS 界面与个人站点时启用。消除 AI 模板化视觉(紫靛渐变、三等分克隆卡片、假评价、✨ 表情胶囊、空洞套话),强制执行语义化设计变量、中英文排版尺度与双端验收。
---

# 前端品味与转化防模板化守则 (VibeCheck)

将本文件放入 `CLAUDE.md`、`AGENTS.md` 或 `.cursor/rules/taste.mdc`,约束编码 Agent 输出有真实产品质感的前端界面。

## 1. 视觉与设计变量纪律
- **语义化色板**:先定义 `--bg`、`--ink`、`--muted`、`--accent`、`--border` 等语义变量,全站只保留一种主强调色。
- **字体与中文回落栈**:大标题收紧字距并拉开字重对比,中文页面必须声明 `PingFang SC` / `Noto Sans SC` 回落栈;正文行宽控制在 `65ch` 内,数据列启用 `tabular-nums`。
- **打破三等分卡片套路**:禁止连续使用三张等高居中「图标 + 标题 + 两行套话」卡片;优先采用左文右物实景舞台、细线台账(Hairline Ledger)或不对称主次网格。
- **克制的合成层动效**:严禁 `transition-all`;只对 `transform`、`opacity` 或颜色属性做 150ms-240ms 显式过渡,并兼容 `prefers-reduced-motion: reduce`。

## 2. 文案、信任与转化守则
- **具体主张替代口号**:H1 用主谓宾说清用户放入什么、得到什么;禁用 `赋能`、`一站式解决方案`、`重塑工作流`、`开启智能新时代`、`elevate`、`unleash` 及破折号口号。
- **明确的主按钮动作**:主 CTA 写出下一步具体结果(如「生成诊断报告」「下载 macOS 版」),不用空洞的「立即体验 / 了解更多」或 `#` 死链。
- **零虚假社会证明**:严禁引入 `pravatar.cc`、`randomuser.me` 随机头像、编造客户头衔或无出处的 `10,000+` 数字;不在胶囊徽章或标题里堆砌 `✨ 🚀 ⚡` 表情。
- **可访问性与双端交付**:保留清晰的 `:focus-visible` 键盘焦点环、正确的 `<html lang>`、`1200x630` 分享大图,并在 `1440x900` 与 `390x844` 下确保零横向溢出。

## 交付前五步工作流

1. **先建变量再写界面**:把背景、文字、描边、唯一强调色与圆角写入 `:root` 或 `@theme`,组件中禁止硬编码散乱色值。
2. **首屏只讲一件真事**:H1 用具体名词+动词说明产品解决什么问题;首屏右侧或下方直接放真实产品界面、代码标本或可交互演示,不放空洞渐变装饰块。
3. **版式做减法与对比**:交替使用双栏标本台、1px 细线台账(Hairline Ledger)与留白,拆掉连续重复的三等分卡片。
4. **双端与无障碍实测**:在 `1440x900` 与 `390x844` 视口核对折行、对比度与零横向滚动;检查所有按钮、表单、`:focus-visible` 与 `prefers-reduced-motion`。
5. **诚实汇报**:区分已实测通过的交互与待接入后端的占位逻辑,绝不虚构测试结论。

或者通过 HTTP MCP 让 AI Agent 按需拉取

$claude mcp add --transport http vibecheck https://vibecheck.itool.tech/mcp