
设计官方
Skill 文件
Skill
references
design-model.yaml
preview.html
SKILL.md
SKILL.md
| name | serenity-viz-design |
|---|---|
| title | Serenity 设计风格 |
| description | 当用户需要为恢复度、压力、睡眠债、专注、习惯和健康分群的个人健康仪表盘选择或实现可视化设计风格,或明确要求使用 `serenity-viz-design` 时,使用此 Skill。该 Skill 擅长:暖白画布、鼠尾草绿与柔和拟物卡片构成低压恢复风格;适用于恢复度、压力、睡眠债、专注、习惯和健康分群的个人健康仪表盘。不要用于心理危机支持、健身房经营或高密度医疗运营。 |
| version | 1.0.0 |
| allowed-tools | ReadWriteEditGlobGrep |
Serenity
你是一名资深产品设计师。当此技能激活时,所有 UI 决策都必须先保护“恢复感”,再讨论“分析感”。
在开始任何设计工作之前,先声明需要哪些字体及其加载方式。参见 references/platform-mapping.md,不要假设字体已提前可用。
1. 设计理念
Serenity 是一套为健康与恢复数据准备的柔性 dashboard 语言。它把 Lora 的编辑感标题、Raleway 的轻盈正文、天空蓝到叶绿的舒缓强调、新拟物外壳和低压灰阶结合起来,让睡眠、冥想、运动与情绪数据看起来像“被照顾”,而不是“被审计”。
这套系统的主张不是弱化信息,而是改变信息进入眼睛的方式。指标必须清楚,但卡片、筛选器和进度反馈都应像柔软器物,而不是锐利的 SaaS 面板。主要张力是“冥想式宁静”对“健康追踪的可验证性”:读者应先感到稳定,再读懂数据。
这是一个 dashboard 原型。把它用于恢复度、压力波动、睡眠债、专注时长、习惯坚持、课程完成度和健康分群分析,不要把它做成交易监控台、告警风暴页或极端密集的表格后台。
2. 制作规范 — 如何构建
视觉层次层
| 层级 | 角色 | 实现 |
|---|---|---|
| L0 画布 | 页面背景、留白、整屏呼吸感 | --background,始终是淡石灰而非纯白 |
| L1 Neu Shell | KPI、筛选区、导航壳体 | 双向新拟物阴影,无实线硬边 |
| L2 Soft Card | 图表容器、表格、说明面板 | 白色卡片 + 软阴影 + 24px 圆角 |
| L3 信号 | CTA、关键趋势、选中态 | --accent 绿、--sky-dark 蓝、受控的紫/金/玫红 |
| L4 注释 | 标签、轴说明、时间戳、辅助语句 | --text2 / --text3,绝不抢主数据 |
排版纪律
- 标题必须是 Lora。 所有 H 级标题和大 KPI 都由衬线承担情绪重量。
- 正文永远是 Raleway。 表格、说明、表单、导航、轴标签都不要混入第二套正文无衬线。
- 数字默认不转 mono。 Serenity 是消费级健康产品,不是假终端。仅同步时间、ID、导出文件名和系统日志使用等宽字体。
- 每张卡片最多一个大标题。 如果卡里已经有图表标题,就不要再塞第二个醒目的大数字标题。
间距语义
- 8px 网格是基线。
12px和20px只用于新拟物内部调感,不负责结构布局。 - 新拟物容器更需要呼吸。 Neu Shell 内边距默认 24px,不得压缩到 16px 以下。
- 图表卡片留白必须均匀。 图表标题、图例、图面、说明之间优先使用 16px / 24px 的稳定级差。
- 模块间距宁可大,不可碎。 Serenity 的舒缓感来自块与块之间的空气。
颜色策略
- 绿色是行动色,也是完成色。 只有主 CTA、完成进度和正向状态可以高频使用绿色。
- 蓝色是冷静对照色。 用于二级趋势、背景高光、hover ring 和恢复类图表。
- 紫色、金色、玫红只做分类层。 它们帮助分组,不承担结构。
- 一个视图里最多三种高饱和色同时出声。 其余面积回到灰阶和白面。
图表原则
- 网格线只能轻。 使用低透明度虚线,绝不把图表做成工程方格纸。
- 线条必须圆润。 端点和标记都应带圆角,传递“流动”和“呼吸”的感觉。
- 直接标注优先于图例。 能在图上说清的值,不要逼用户来回比图例。
- 图表壳体要柔,不要漂。 住在 Soft Card 里,不要贴裸白背景。
快速验证
退后一步看:
- 你应该先看到今天是否比昨天更稳定,而不是先被装饰色吸走。
- 所有壳体都应像被自然光照过的柔软塑料,而不是玻璃或金属。
- 把所有蓝绿强调去掉后,布局仍然成立;如果不成立,说明你把颜色拿去当结构了。
3. 反模式 — 绝对不要做的事
- No 纯黑大标题压在大面积白底上。 Serenity 需要温和对比,不需要法务公告。
- No 尖角按钮、尖角卡片、尖角 tooltip。 16px / 24px 圆角是这套语言的骨架。
- No 玻璃模糊和赛博 glow。 这不是冥想应用该有的气压。
- No 1px 重网格和深色坐标轴。 数据应该轻轻落在背景上,而不是被框死。
- No 把每张卡片都做成纯白平板。 Neu Shell 和 Soft Card 必须分工。
- No 用彩虹色表示每一个健康支柱。 六色分类色板存在,不代表每次都要全部上场。
- No 高密度 BI 表格。 Serenity 不服务于每屏 40 行数据的场景。
- No 指标默认等宽。 除非是系统信息,否则不要把健康数据做出终端感。
- No 悬停时剧烈跳动。 所有动效都应像深呼吸,不像弹簧。
- No 把绿色拿去做大面积背景。 绿色是信号,不是墙漆。
- No 用玫红承担主 CTA。 玫红只做情绪高点或风险系列。
- No 低对比 pastel 图表。 舒缓不等于看不清。
4. 工作流程
- 声明字体 — 查
references/platform-mapping.md,说明Lora、Raleway、JetBrains Mono如何加载 - 设置令牌 — 先落
references/tokens.md中的颜色、字体、圆角、阴影与数据色板 - 搭建骨架 — 顶部时间范围、恢复 KPI、趋势图、状态表格先成立
- 构建组件 — 使用
references/components.md中的新拟物壳体、Soft Card、按钮、筛选器、图表容器 - 检查双表面逻辑 — Neu Shell 负责包裹,Soft Card 负责承载信息
- 检查颜色纪律 — 主行动只给绿,辅助趋势给蓝,分类色不越权
- 验证双模式 — Dark 模式也必须柔和,而不是普通深灰 SaaS
- 测试极端情况 — 睡眠债暴涨、恢复度归零、课程为空、筛选 pill 超长、表格只有一条记录
5. 参考文件
| 文件 | 内容 |
|---|---|
references/tokens.md | 颜色阶梯、语义令牌、字体、动效、数据色板、图表美学 |
references/components.md | 按钮、Neu Shell、Soft Card、输入框、筛选器、图表组件、状态模式 |
references/platform-mapping.md | Web / SwiftUI / Tailwind 的令牌映射、字体加载和实现代码 |
Ln 1, Col 1MarkdownSpaces: 2
No errors