← 全部文章

design-taste-frontend 的官网构建与验收流程

tasteskill(design-taste-frontend)的使用场景与完整流程:deal 抽取、kit 构建、五脚本检查与 finish gate 验收,覆盖从零建站、redesign 与去 AI 味三个场景。

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:

  1. 任何图片/渲染/视觉下无 caption,credits 收进 footer 一行。
  2. 每个视觉真实渲染(绝不空地面),1440/1024/768/390 全成立。
  3. One section per screen:hero 独占首屏,每 section 恰 1-2 屏。
  4. Equal edges:左右内容边缘相等(.wrap 上限 1280px,place 1200)。
  5. hover 微动效 + hero 入场一次(data-enter)+ 每页 1-2 个 dealt moment。
  6. 更多更好真实照片。
  7. 真实全彩图标(绝不手绘)加卡内小型 diagram。
  8. shader 效果与场景只给 tech/software/gaming;cafe/bakery/guesthouse/shop 绝不用,用照片。
  9. 地址只街名加街区;无门牌号/邮编/坐标/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。

© 2026 llmons