design-taste-frontend(tasteskill)的官网构建与验收流程
一、目标
design-taste-frontend(自称 tasteskill 2.5.1,“the anti-slop frontend skill”)是面向营销官网的 skill 集合包:SKILL.md 权威工作流,22 个 references,10 个 Node 检查脚本,外加自带的设计系统 kit(11 个 hero 模板、约 20 个 UI 片段、13 个在用 moments、24+ 个 shader 效果、64 套行业配色与字型配对库)。目标是把页面做到 figma.com、x.ai 的水准,用可执行的硬规则和真实浏览器验收清除「模板味」与「AI 味」。
适用:build / design / redesign / restyle / polish / review 任意落地页、公司站、商店、cafe、酒店、工作室、SaaS、AI、开发者工具或游戏站点。不适用:文档站、Web 应用内部界面等非营销页面。
二、环境前提与安装
- Node 22+;Chrome/Edge/Chromium(每个检查脚本各起一个 headless Chrome;ffmpeg 可选,用于照片裁剪与 WebP)。
- 安装位置:
~/.claude/skills/design-taste-frontend/。 - 调用:Claude Code 中输入
/design-taste-frontend,或自然语言命中触发短语(说页面「generic、templated、AI-made」即触发)。一旦调用,Stop hook 自动生效:agent 每次想结束回合,hook 先跑 gate,有未修复 FAIL 就阻止结束并列出修复清单。 - 技术栈:首选纯静态 HTML/CSS/JS(复制 kit 进项目
assets/、从assets/starter.html起步);也支持既有 React、Next.js、Vue、Svelte、Astro、Tailwind 项目(kit 框架无关,复制到public/assets;Next.js 需output:'export'静态导出)。 - 硬约束:页面必须经
http://127.0.0.1临时端口服务(file://下 kit 全空);绝不用 3000 端口。
三、核心机制速览
- Deal, never choose by taste:hero、配色、字体、moment、版式全部由脚本随机抽取(带 history 防跨项目重复),不许凭感觉挑;取第一个结果,仅在与客户 logo/照片冲突或 hero 压力测试失败时才取下一个;抽到 violet 一律重抽。
- kind 判定:页面用
<html data-type>与<meta name="page-type">、<meta name="site-kind">声明类型:
| 页面 | data-type | site-kind |
|---|---|---|
| SaaS / AI / devtool / fintech / 卖软件的 studio | software | software |
| game | software | gaming |
| 硬件/科技产品 | product | tech |
| 其他实体产品/品牌 | product | product |
| 被雇的人(诊所/律所/agency/创意工作室) | service | service |
| 人们去的地方(cafe/餐厅/酒店/商店/健身房) | place | place |
「Tech」= site-kind 为 software/gaming/tech:shader 效果、大场景、循环、CSS 地面、暗色页面仅 tech 可用;其余只用照片、平色、文字、真实图标、hero 入场与 dealt moment。
- finish gate:Step 1 就武装
gate.mjs(产出.taste-skill/build.json),默认最多 3 轮修复;末行输出GATE: PASS / FAIL / OPEN / DONE / SETUP / ERROR / OFF。
四、完整工作流(Step 0-7)
Step 0:确定技术栈
空文件夹走 starter 路线;既有项目用项目自己的栈、kit 进 public/assets;Next.js 静态导出。
Step 1:读 brief 并武装 finish gate
确认页面 kind、卖什么、卖给谁、唯一主行动(transaction:Book a room / Order a cake / Start a free trial;place 用 Get directions),然后先于任何页面:
node <skill>/scripts/gate.mjs --start index.html --kind <kind> --category "<卖什么>" --primary "<主行动>"
Step 2:先写全部文案
产出 fact sheet(brief 真实事实)、voice card(语域取自 copy-registers.md 的 12 种语域,禁默认 model 腔;语域恒定,价格/FAQ/表单始终平实)、page shape(按读者问题排序:这是什么 → 适合我吗 → 为何信 → 怎么用 → 多少钱 → 出问题怎么办 → 现在做什么)、device budget(修辞配额)。文案五条规则:h1 命名品类加买家或地点(2-8 词);首屏一个 hard fact(数字/地点/价格/日期);每个标题有名词;按钮等于动词加宾语(禁 Learn more / Read more / Discover / Click here);行动少而一致(hero 不超过 2 个、place 1 个,主行动在 nav/hero/close/手机 bar 里逐字相同)。只许虚构:coined 品牌名(搜索记录存页面旁 names.json,禁 Kestrel/Halcyon/Lumen/Nimbus 一类模型惯用名)和 place 的合理营业时间/价格(标 data-assumed)。
Step 3:按屏规划
plan 记录:kind;deal 与「为什么该配色适合该行业」;每 section 一行(id、一个想法、图片及 kind、1 还是 2 屏、moment 放哪节及为什么动)。place 页长度由照片数决定(12-20 张全页 6 屏 / 8-12 张 4-5 屏 / 少于 8 张变 3 屏短页)。
Step 4:抽取(deal)
# hero(11 选 1;place 固定满幅照片 hero 不抽取)
node <skill>/assets/layout/deal.mjs --type <page type> --has photo,ui,film,object,setting --history .taste-skill/layout-history.json
# 配色与字体(三套行业配色、三套配对,取第一个)
node <skill>/scripts/start.mjs deal --page <kind> --trade <trade> --history .taste-skill/history.json
node <skill>/scripts/start.mjs css --page <kind> --palette <id> --type <id> --radius soft --history .taste-skill/history.json
# 客户有品牌色时用 brand 代替 css
node <skill>/scripts/start.mjs brand --page <kind> --bg "#.." --ink "#.." --accent "#.." --type <id> --radius soft
# moments(每页 1-2 个)
node <skill>/scripts/moments.mjs pick --page <kind> --count 2 --fits section,statement --photo --history .taste-skill/history.json
nav/footer/close/rhythm/buttons/mark 六个 dealt 列表按 sections.md 中对应 kind 的整行抽取。结果写上 plan 第 2 行与 <body> 顶部注释,严格照建;:root 块原样保留。
Step 5:构建
starter.html 设 lang、data-type、data-radius、data-buttons、data-motion 与三个 meta;只复制 assets/layout/hero-<id>.html 的 hero <section>(模板里的 nav/footer 绝不带入);每 section 等于 main > section 加一个 .wrap;UI 片段从 assets/ui/<name>/fragment.html 粘贴后重写一切名字/数字/logo;最后 icons.mjs scan index.html --out assets/icons --colour 补齐真实品牌图标。
Step 6:检查与目视
一次一个、前台、10 分钟超时地跑:
node <skill>/scripts/copy-lint.mjs index.html --kind <kind>
node <skill>/scripts/consistency.mjs index.html --widths 1440,1024,820,768,390 --rhythm-widths 1440,820,768,390 --profile <dir> --page <kind> --category "..." --primary "..."
node <skill>/assets/layout/check.mjs --url index.html --profile <dir> --sizes 1440x900,1024x768,820x1180,768x1024,390x844 --shots shots/layout
node <skill>/scripts/shoot.mjs --url index.html --w 1440 --out shots/1440.png --profile <dir>
node <skill>/scripts/perf.mjs index.html --profile <dir>
node <skill>/scripts/gate.mjs index.html
check.mjs 的每个 finding 都算失败(禁 --no-stress);copy-lint 的 WARN 也要修或说明理由;修复轮用 consistency.mjs --quick --widths 1440,390。gate 至多 3 轮,修到 PASS;轮次用尽则把 open FAIL 写进报告收尾。
Step 7:报告
GATE 行置顶;kind 与全部 deal(配色加为何适合行业、字体配对、hero、effect、moments);voice card 一行与保留的 WARN 及理由;checker/layout/perf 结果;没能检查的项;全部 assumed 事实与品牌名搜索记录;客户必须提供的照片/素材清单(每个 stand-in 帧)。
五、三个典型场景
- 从零建站:完整走 Step 0-7。人工确认点:kind 归类、客户自有品牌色(走
start.mjs brand)、轮次用尽或用户喊停(gate.mjs --done "<用户原话>")。 - 重塑已有页面(redesign):Step 0 走既有项目分支,组件沿用 starter 的标记与类名、kit 进
public/assets;gate 用--start http://localhost:5173/(dev server 运行中)或--start dist/index.html --root dist(每次 gate 前重新 build);deal 照常抽取防止旧习惯延续;文案层照常重写。 - polish「AI 味重」的页面:触发短语即 “looks generic, templated or ‘AI-made’”。流程以检查工具组为核心:先 copy-lint、consistency、layout check、perf 找出问题,再按 references 逐条修复,最后 gate 验收。与建站的差别:不重 deal(除非整页重建)、先检查后修改。
六、关键规则速查
九条 house rules:
- 任何图片/渲染/视觉下无 caption,credits 收进 footer 一行。
- 每个视觉真实渲染(绝不空地面),1440/1024/768/390 全成立。
- One section per screen:hero 独占首屏,每 section 恰 1-2 屏。
- Equal edges:左右内容边缘相等(
.wrap上限 1280px,place 1200)。 - hover 微动效 + hero 入场一次(data-enter)+ 每页 1-2 个 dealt moment。
- 更多更好真实照片。
- 真实全彩图标(绝不手绘)加卡内小型 diagram。
- shader 效果与场景只给 tech/software/gaming;cafe/bakery/guesthouse/shop 绝不用,用照片。
- 地址只街名加街区;无门牌号/邮编/坐标/VAT;电话不用真实格式;联系用
.example。
其他高频硬规则:
- 禁用字体:Inter、Roboto、Open Sans、Lato、Montserrat、Poppins、Space Grotesk、Plus Jakarta Sans;标题禁 700/800 字重;正文不小于 16px,行不超过 62 字符。
- 绝不 violet/lavender(OKLCH 色相 270-330 转为 255 蓝或 345 玫红),第三方 logo 例外。
- 绝不发明评论/评分/引用/统计/客户/媒体(proof 只来自 brief);禁用词(delve/seamless/cutting-edge 等)与 gen-2 tells(两段式标题、对比框、否定排比、eyebrow、“Most popular” 等)各有每页配额,超配额 WARN,翻倍即 FAIL。
- 动效恰三层:hero 入场、1-2 个 moment、hover 层;绝无滚动入场、视差、scroll-jacking、磁性按钮、自动轮播。
- 性能预算:传输 3000 KiB、图片 2400 KiB(单张 700)、JS 900 KiB、请求 110、字体 3 族/320 KiB、FCP 4.5s、LCP 8s、CLS 0.25、WebGL context 4 个。
七、验证
| 工具 | 检查什么 |
|---|---|
| copy-lint.mjs | 文案 tells 计数(无浏览器,秒级) |
| consistency.mjs | 浏览器内视觉与可访问性检查器,逐项比对 kit 规则 |
| check.mjs | 版式违规(hero-fold、screen-height、edge-left、overflow-x 等) |
| shoot.mjs | 整页截图加分节 tile,供人工目视 |
| perf.mjs | 性能预算 |
| gate.mjs | finish gate:复跑 checker、320 宽走查溢出与 44px 点击目标、copy-lint |
gate 末行含义:PASS 通过;FAIL <n> (round <k>) 本轮未过继续修;OPEN <n> 轮次用尽,停止修复收尾报告;DONE 用户明确说停(--done "<用户原话>");SETUP 页面没起来,先让 --start 指向能打开的页面;ERROR/OFF 写进报告收尾,不要重跑。
八、常见问题
- gate 一直拦着会话结束:这是设计行为(Stop hook);确认可以发就跑
gate.mjs --done "<用户原话>"结束。 file://打开页面 kit 全空:必须走http://127.0.0.1临时端口;也不用 3000 端口。- 豁免(waivers.json):需要 {check, target, reason} 三字段;超过 5 个豁免本身就是 FAIL(“too many waivers: fix instead”);改 kit 文件与骗 checker 两类不可豁免。绝不改 kit 或写代码绕过 checker。
- subagent 不被 Stop hook 拦:hook 只 block 首个会话,subagent 需手动跑 gate。
- 慢是预期:headless Chrome 的 WebGL 走 CPU 渲染。
- 同会话做多站:设
TASTE_SKILL_RECENT=<file>共享抽取历史防重复。 - 中文站点:规则与检查器以英文文案和西文排版为默认(62 字符行宽、13px labels 等),中文站点需人工适配部分文案规则。
九、回滚与恢复
- 卸载:删除
~/.claude/skills/design-taste-frontend/目录,重启会话即失效。 - 状态清理:
.taste-skill/(build/gate/waivers/history 等状态)与shots/截图目录可整目录删除,不影响页面本体。 - kit 被改坏:skill 规定绝不手改 kit 文件;如已改动,重装 skill 覆盖恢复原始 kit。
- gate 卡住:
gate.mjs --done "<用户原话>"明确收尾;GATE: OFF表示当前没有活跃 build。