Communitygithub.com

分析仪表盘设计

构建、重新设计或评审一个产品分析仪表盘,采用Cloudflare风格的冷静布局:包含带有变化量和迷你趋势图的KPI行、基于标签切换的单一图表、可排序的国家/地区表格、从网站到应用到付费的漏斗、买家旅程、留存队列、应用健康度、流量来源和事件日志——所有数据均真实准确、尊重隐私,并通过截图QA审查。适用于统计页面、独立应用或SaaS分析仪表盘、“我的产品表现如何”页面、管理员指标屏幕,或当有人质疑仪表盘数据不一致时的场景。

分析仪表盘设计 是什么?

这是一个用于设计、构建或审查产品分析仪表盘的AI技能,其风格借鉴了Cloudflare的冷静、极简设计理念。技能核心在于确保仪表盘能够一目了然地回答“产品是否在增长,以及用户在哪里流失”这一首要问题。它通过一个严格的工作流程来实现:从定义数据契约开始,确保每个数据字段都有明确的定义和唯一来源;然后按照用户旅程顺序布局页面,并构建标准化组件;接着进行“诚实性”和“隐私性”审查,确保所有数据准确、窗口明确,并且尊重用户隐私(如无cookies、无IP存储);最后通过截图QA进行视觉和数值验证。该技能适用于任何需要构建或改进产品分析界面的场景,无论是独立应用、SaaS产品还是内部管理后台。它支持生成一个完整的HTML示例(如`examples/product-analytics.html`),并提供了详细的参考文件来指导每个步骤和组件(如指标、布局、组件、令牌、代码片段、隐私和QA指南)。技能还定义了一套严格的通用规则,包括保持用户旅程顺序、为每个数字明确标注时间窗口、对极小的基数不进行夸大展示、显示“未知”数据、保持数据新鲜度可视化,以及确保所有图表均可切换为数据表格。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/boburjonmavlonov/analytics-dashboard-design-skill/tree/main/skills/analytics-dashboard-design

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

分析仪表盘设计 是做什么的?

一个产品仪表盘在第一眼就需要回答一个问题:它在增长吗,人们在哪里流失? 页面上的所有内容都是为了回答这个问题,然后让所有者深入探究原因。

此技能是从构建和运行一个已发布Mac应用的(网站 → 下载 → 安装 → 试用 → 付费)分析仪表盘的实践中提炼出来的,也来自其所有者每次在截图中发现的所有错误。工作示例是包含固定样本数据的 examples/product-analytics.html。

工作方法

按顺序执行以下步骤。每个步骤都以“完成标准”结束,你需要能够确认。

1. 首先编写数据契约

在任何UI之前,列出页面将显示的每个数字,以及每个数字的:它计数的事件、计数窗口、是否为独立访客或总计、时区,以及它与哪个“上一周期”进行比较。将数据契约放在API响应结构中,而非UI代码中。参见 references/metrics.md。

完成标准 每个磁贴、列和图表在契约中都有一行,并且两个显示“相同”数字的位置都从同一个字段读取。

2. 布局页面

侧边栏包含各个部分的链接,一个带有新鲜度状态和周期切换的固定顶部栏,然后按照旅程顺序排列各区域:概览 → 国家/地区 → 漏斗 → 买家 → 应用 → 留存 → 网站 → 事件。内容列宽度不超过1280像素。参见 references/layout.md。

完成标准 在1440×900分辨率下,概览部分无需滚动即可回答第一眼的问题。

3. 根据参考构建组件

使用 references/components.md 中的模式和 references/snippets.md 中的代码:极细线KPI行、带有“之前是怎样的”基准线的变化量、图表窗口内的迷你趋势图、在单一图表下方的下划线式指标标签页(带有表格切换开关)、可排序的国家/地区表格(在排序列中包含份额条)、具有步骤转化率的漏斗条、可展开的买家行(带有时间线)、带有显式“未报告”切片的环形图、具有分层类别的留存热力图。

颜色仅来自 references/tokens.md 中的令牌;必须同时支持亮色和暗色主题。

完成标准 没有一个组件使用令牌之外的任何颜色、圆角或字号。

4. 诚实性检查

逐节检查 references/metrics.md。常见问题:基数为1显示“-100%”,收入滞后于支付提供商,0美元的订单被计为客户,每日独立访客的总和被标注为独立访客,环形图的份额悄悄丢弃了未报告的用户,“来源”是猜测却被当作事实展示。

完成标准 每个数字都说明其窗口,每个估计都说明它只是一个估计。

5. 隐私检查

用户信任的产品分析不能成为用户不信任的东西。遵循 references/privacy.md:网站无Cookie,不存储IP,事件中不包含用户内容,使用基于安装的随机ID,应用中提供退出机制,以及通过每日加盐哈希连接的旅程(绝不通过身份标识连接)。

完成标准 你可以将事件模式直接粘贴到产品的隐私政策中而无需编辑。

6. 截图QA

执行 references/qa.md 中的步骤:在1440、1024和390像素分辨率下,亮色和暗色主题,每个周期,获取真实截图,并将总数与页面外部计算的值进行核对。观察图片,而非代码。

完成标准 所有截图清晰整洁,并且已知的总数匹配。

普遍适用的规则

  • 旅程顺序。 各部分遵循客户所走的路径,因此用户流失可以自上而下地阅读。
  • 每个数字标注一个窗口。 “周期内”、“今天”、“过去30天”等字样应放置在列标题下或磁贴提示中。
  • 同类比较。 上一周期具有相同的长度,并结束在当前周期开始之时。
  • 极小基数时不夸大。 0→3是“新的”,而非“+∞%”;1→2的变化量显示但保持低调。
  • 未知项是一行,而不是一个空洞。 未知国家、未报告的权限和不匹配的来源都应显示出来,排在最后,并计入总数。
  • 新鲜度可见。 在页头显示“更新于 09:00 UTC”和“支付同步于 08:57”;当加载失败时,显示一个红点和通俗易懂的错误信息。
  • 表格始终一键可达。 每个图表背后都应有每日精确数据,并通过“表格”切换开关提供。
  • 键盘和屏幕阅读器支持。 图表可以获取焦点,并使用← →键逐点浏览;可排序列标题是带有aria-sort属性的按钮;可展开行是带有aria-expanded属性的 role="button"。
  • 无外部依赖。 SVG、CSS锥形渐变和Intl即可覆盖此处所有图表;示例就是一个独立的HTML文件。

风格规范

中性灰色,一种蓝色系列色,仅表示好和坏使用绿色和红色,橙色仅用于品牌标识。正文基础字号13.5像素,KPI值24像素,数字和标题使用600字重,任何可能变化的数字位置都使用表格数字。使用极细线而非阴影。卡片圆角8像素,控件圆角6像素,条形圆角4像素。参见 references/tokens.md。

评审格式

当被要求审查一个仪表盘(代码、URL或截图)时,请按以下顺序回答:

  1. 结论 — 一句话:它是否回答了第一眼的问题?
  2. 不一致的数字 — 同一指标显示两个值、总数不匹配、窗口不一致。这些优先指出,因为它们会摧毁信任。
  3. 诚实性问题(来自 references/metrics.md)。
  4. 隐私问题(来自 references/privacy.md)。
  5. 布局和组件问题,按拖慢所有者的程度排序。
  6. 做得好的地方 — 简短但要说出来,这样重新设计时不会丢失它。

每个问题:你看到了什么,它为什么具有误导性或拖慢效率,以及修复方法。

参考文件

文件内容
metrics.md数据契约、计数窗口、变化量、收入、归因、漏斗、队列
layout.md侧边栏、顶部栏、区域顺序、网格、断点、手机布局
components.md页面中每个组件、其状态及无障碍性
tokens.md亮色和暗色颜色令牌、字体和间距伸缩比例
snippets.md变化量、刻度、桶、迷你趋势图、环形图、条形列表、热力图层级、复数
privacy.md无Cookie访问、哈希网络、安装ID、退出机制、绝不可收集的内容
qa.md截图协议、已知总数、气味表
case-study-typecorrect.md该技能来源的真实仪表盘,以及每条规则修复的Bug

相关技能