finesse-ui 是一个用于构建网页界面的技能(skill),其目标可概括为:技术上出彩、灵魂独特、绝不廉价。它并不是针对单一页面类型,而是按 register 路由,同一套工艺底线适用于所有界面,但底层与中段会分叉。
用途与 register 划分
finesse-ui 构建两类核心界面,并按 register 路由:
brand —— 设计本身就是产品。适用于落地页、品牌站、发布页、作品集、主视觉页(hero pages)。优化方向是视觉冲击、灵魂与第一印象,需要真正的视觉引擎和鲜明的个性。
product —— 设计服务于产品。适用于仪表盘、管理面板、分析页、数据表格、应用外壳、设置页。优化方向是清晰、密度与可用性,同时仍然要求绝不廉价。
除此之外还有两个 register:
commerce —— PDP/PLP/购物车/结账,属于混合型,按具体页面在做什么被路由到 brand 或 product。
h5 —— 仅手机屏幕:app UI、活动页、移动端 PDP、报告 H5。它是一个容器:先固定框架、安全区域、拇指层级与系统家具,再包裹上述三种之一作为内容语法。移动端 PDP 是 h5 + commerce;app 仪表盘屏幕是 h5 + product。h5 从不替代内容 register,只做包裹。
资料强调:所有规则都是情境化的,不会自动触发;应先读 brief、设定 register,再只取适用的部分。
使用方式
使用前先检查 scope。如果 brief 只是单个元素(按钮、输入框、卡片、弹窗、toast),应改用 references/component-scope.md 的组件流程,步骤 1–6 属于页面装置,对单个组件是错误的。
主要步骤:
- 运行 §0 Brand Read:先读 .finesse/log.json(轮换记忆),再在写代码前推断 register(brand vs product)与灵魂,输出 Design Read(坐标行、用户可否决的“You'll see:”行、列出每个图片位置及来源的“Images:”行、两个最可能的反对意见,以及一句轮换说明)。在写 Images 行前检查本次会话实际可用的工具列表(图像生成工具、MCP 图像工具、网络抓取或都没有),因为这会决定能诚实提供什么;并在命名某条路径前证明它确实能在当前环境运行。提出后等待,绝不凭自己的推断生成或下载。
- 设定 §1 三维拨盘:SOUL · SPECTACLE · DENSITY。product register 固定 SPECTACLE 低、DENSITY 高。
- 铺设底层(substrate):所有 register 共享通用工艺底线(带色偏的中性色、不使用 #fff/#000、半透明/发丝线边框、带色阴影、对比度下限)。底线之上会分叉:brand 走品牌底层(颗粒、暗角、clamp() 展示字体、默认深色、分层 hero 深度);product 走产品底层(高级表面/卡片、KPI 瓷砖、浮动面板、固定字号体系、仅反馈性动效),绝不能把颗粒/暗角/巨大 hero 字体/默认深色/hero 引擎灌进仪表盘;h5 先立框架(视口契约、锁定 body + 可滚动 #app、560px 桌面手机框、安全区域计算),框架立好后再铺它包裹的 register 的底层。
- 继续分叉:brand 选一个 §2 灵魂并构建 §4 hero 引擎;product 先选调色板(中性色阶占 80% 像素,跳过此步会导致仪表盘发蓝),再按页面任务分:读的页面(仪表盘、分析、监控)参考 product-ui.md,写之前打开 examples/ 中最接近的仪表盘参考;操作的页面(发布/创建向导、商家与管理控制台、配置、设置、审核队列)在 product-ui.md 之上叠加 workflow-ui.md;委托的页面(AI 工作台、agent 控制台、copilot UI)在 product-ui.md 之上叠加 ai-console.md。h5 先从六种形态中选一种,再加载它包裹的内容 register 并遵循上述分支。
- 组装骨架:brand 从四种品牌骨架中按页面任务选一种;product 的骨架是 product-ui.md §1 的 shell 形态;h5 的骨架是框架加上所选形态。三者都要求动效有动机。
- 交付前运行 §6 Cheapness Blacklist、mobile floor 与 §8 Pre-Flight。h5 构建改跑 h5-mobile.md §9–§10。然后记录构建:追加到 .finesse/log.json 并在 CSS 上打戳。未记录的构建会被下一次运行撞车。
参考文件
references/*.md 是深度材料,应按当前阶段按需加载,不要全部内联。资料中列出的参考文件包括:component-scope.md(单个元素时使用)、divergence.md(反同质化层)、design-dna.md(品牌底层)、theming.md(明暗切换/多主题)、motion.md(动效)、hero-engines.md(hero 引擎)、page-crafting.md(品牌实现层)、h5-mobile.md(仅手机页面)、mobile-floor.md(手机显示底线)、3d-effects.md、style-personas.md、inspiration-catalog.md、plain-words.md、anti-cheap.md、product-ui.md、workflow-ui.md、ai-console.md、product-palettes.md、examples/EXAMPLES.md、dataviz.md、chart-crafting.md、commerce-ui.md、asset-sourcing.md。
适用场景与限制
finesse-ui 适用于需要高工艺、避免 AI 同质化观感、且需要区分品牌型与产品型界面的网页构建任务。它明确反对将品牌语法用于仪表盘、或将仪表盘示例强行套用到表单流程。对于单个组件需要走单独的组件流程,并强制要求所有八种状态齐备。
资料未提供该技能的价格、收费方式、平台依赖、性能数据或效果承诺,这些事实暂未提供。