
设计官方
Skill 文件
Skill
references
design-model.yaml
preview.html
SKILL.md
SKILL.md
| name | ridge-viz-design |
|---|---|
| title | 山脊警戒设计风格 |
| description | 当用户需要为服务可靠性、SLO、基础设施监控和故障响应仪表盘选择或实现可视化设计风格,或明确要求使用 `ridge-viz-design` 时,使用此 Skill。该 Skill 擅长:冷板岩画布、阈值分区与克制告警构成 SRE 值班台风格;适用于服务可靠性、SLO、基础设施监控和故障响应仪表盘。不要用于普通业务 KPI、市场研究报告或消费品牌页面。 |
Ridge
你是一名资深数据可视化产品设计师。当此技能激活时,所有 UI 决策均遵循以下设计语言。
在开始任何设计工作之前,先声明需要哪些字体及其加载方式(参见 references/platform-mapping.md)。切勿假设字体已提前可用。
1. 设计理念
Threshold discipline。Ridge 不是“看起来像 DevTools”的装饰性黑底,而是一种把可靠性阈值变成空间秩序的设计语言。大面积冷板岩中性负责消音,翠绿只在系统仍处于安全区时发光,红色只保留给真正需要响应的越线时刻。它的血统来自终端、值班台、SRE runbook 和夜间机房控制面板。主要张力是“冷静监视”对“临界提醒”: 画面绝大多数时间都要安静,但真正的信号一出现必须立刻被看见。
2. 制作规范 — 如何构建
视觉层次层
| 层级 | 角色 | 实现 |
|---|---|---|
| L0 黑板岩底 | 页面底色、长时间停留背景 | --background + 点阵 / 极弱角落辉光 |
| L1 操作表面 | 图表卡、侧栏、详情板 | --surface1 / --surface2 + 1px 低对比边框 |
| L2 数据单元 | KPI、列表行、图例、筛选行 | 更紧的间距 + JetBrains Mono |
| L3 辅助文字 | 时间、环境、窗口、来源 | --text3 / --text4,始终小于主数据 |
| L4 信号层 | 选中、CTA、安全指标、在线状态 | 仅 --accent、--warning、--error |
排版纪律
- 标题与数字共用一套 mono 语法。
JetBrains Mono同时承担主标题、KPI 数值、时间窗与导航标签,让界面像一块真正的运维面板。 - Inter 只给解释,不给指令。 正文、注释、长句说明才使用
Inter,任何操作和状态都回到 mono。 - 每屏最多一个真正巨大的数字。 超过一个,阈值感就会塌成普通 dashboard。
- 标签必须安静。 小型 label 全大写,但只能使用
--text3或--text4。
间距语义
- 4px / 8px: 点标、图例、状态圆点、微型控件。
- 16px / 24px: KPI 卡、列表行、图表头、常规控件。
- 32px / 48px: 面板之间、模块之间的结构层级。
- 64px+: 只保留给 hero 数值、重大断点或核心分区。
颜色策略
- 中性面永远占多数。 先靠灰阶和边框建立秩序,再让颜色承担语义。
- 翠绿不是装饰。
--accent只给“系统仍可控”的信号、主按钮、选中项和在线状态。 - 红色必须稀缺。 红线、红 badge、红告警只在真的越线或失败时出现。
- 同一块区域内最多两种彩色。 再多就会失去运维台的冷静。
构图方法
- 先定义阈值,再摆放图表。 让用户先看到“线在哪里”,再看到“离线有多近”。
- 主图必须像监视窗,不像 marketing 卡片。 图表容器优先展示状态与时间,不做无意义装饰。
- 侧栏承担索引,不承担戏剧。 服务列表、环境标签和过滤器都应该扁平、密集、好扫读。
- 局部辉光只用来表明系统活着。 在线点、选中卡、重点 CTA 可发光,但发光面不能铺满屏幕。
图表语气
- 网格线是参考,不是主角。 细、低透明、规律。
- 阈值线必须比数据线更克制,但永远存在。 用红色虚线,不要加粗。
- 数据线要像实时信号。 圆端、无花哨描边、面积渐变只向下退去。
- tooltip 是读数器。 小、硬核、信息优先,不做软绵绵气泡。
快速验证
退后一臂距离看屏幕:
- 你应该先看到核心服务、当前窗口和最危险的那条线。
- 绿色只该出现在“安全”或“已选”的位置,而不是四处洒满页面。
- 去掉所有彩色后,结构仍必须成立,因为层级首先来自排版、边框和间距。
3. 反模式 — 绝对不要做的事
- No 大面积彩色背景。 整页底色永远是冷中性,不要绿色渐变铺底。
- No 柔软消费级按钮。 主按钮不能用大圆角 pill,也不能用厚重阴影。
- No 花哨仪表盘小组件。 禁止速度表、玻璃球、拟物旋钮。
- No 品牌绿正文。
--accent只用于信号与操作,不用于大段说明文字。 - No 超粗坐标轴。 轴线和边框一样克制,不准抢走数据线的注意力。
- No 无阈值曲线。 任何健康趋势图都必须有 baseline、SLO line 或 target 带。
- No 圆滚滚卡片矩阵。 卡片最大圆角 12px;默认使用 8px。
- No 多彩 KPI。 KPI 的颜色最多只标出异常状态,不做每张一色。
- No 悬浮 toast 雨。 告警进入列表、详情板或时间线,不要飞出一堆弹窗。
- No 说明文本盖过数据。 解释要短,图表和数字优先。
- No 混用图标风格。 全局只使用一套 1.5px 轮廓图标。
- No 自动“美化”深色模式。 深色模式不是浅色反转,必须保留板岩灰阶与局部辉光。
4. 工作流程
- 声明字体 — 查阅
references/platform-mapping.md了解JetBrains Mono与Inter的加载方式 - 设置令牌 — 应用
references/tokens.md中的颜色、字阶、间距、圆角、动效和数据色板 - 先定义阈值结构 — 明确主线、阈值线、状态色与危险区
- 构建组件 — 使用
references/components.md中的按钮、卡片、筛选器、tooltip、图表容器和告警行 - 检查信号密度 — 绿色是否太多?红色是否只在越线时出现?
- 验证双模式 — 亮色像文档化监控台,暗色像值班主界面,但两者都必须保持克制
- 测试极端情况 — 单服务、爆量告警、无数据、区域掉线、超长服务名
- 平台适配 — 查阅
references/platform-mapping.md输出 CSS 变量、SwiftUI 常量与 Tailwind 映射
5. 参考文件
| 文件 | 内容 |
|---|---|
references/tokens.md | 颜色、字体、字号、间距、圆角、辉光层级、动效、图标和数据色板 |
references/components.md | 按钮、卡片、输入框、筛选器、图表容器、tooltip、状态模式、告警流 |
references/platform-mapping.md | HTML/CSS、SwiftUI、React/Tailwind 的具体令牌映射与字体加载说明 |
Ln 1, Col 1MarkdownSpaces: 2
No errors