SuperAPI AI 工具集

measure-dashboard-requirements

数据与分析

查看项目

更新于 10-15 15:22

技能介绍

用途

该技能用于产出一份看板需求文档,规定一个看板应当回答哪些问题、展示哪些指标,以及数据应如何可视化。清晰的需求有助于数据团队构建真正能支持决策的看板,而不只是堆砌数字。

何时使用

  • 向数据/分析团队申请新看板时
  • 为产品、功能或团队定义 KPI 跟踪时
  • 将临时报表固化为常设看板时
  • 季度规划之前,明确需要什么可见性时
  • 为需要自助分析的干系人做入门时

何时不使用

  • 需要为看板提供数据的事件埋点:应使用 measure-instrumentation-spec;先埋点,后可视化
  • 你在设计实验读数,而不是常设看板:应使用 measure-experiment-design 和 measure-experiment-results
  • 你想在周期结束时为 OKR 进展打分:应使用 measure-okr-grader
  • 看板应回答的问题尚未达成一致:应先用 foundation-okr-writer 或 define-problem-statement 框定结果

使用方式(步骤)

  1. 定义目的:从看板应回答的问题开始,而不是从要展示的图表开始。这个看板将支持哪些决策?没有明确目的的看板会变成虚荣指标展示。
  2. 识别受众:明确谁会使用该看板、使用频率以及使用场景。高管的每周复盘与团队的每日站会看板需求不同。
  3. 指定关键指标:为每个指标记录名称、业务定义(用平实语言)、计算公式、数据来源以及基线/目标值。含糊的指标会导致看板偏离一致预期。
  4. 设计可视化:根据数据应传达的信息推荐图表类型。时间趋势用折线图;比较用柱状图;构成用饼图/矩形树图。并包含维度拆分。
  5. 定义筛选与细分:明确用户需要哪些下钻:日期范围、用户分层、产品模块、地理区域。预判用户会提出的“切片与切块”问题。
  6. 记录数据来源:识别数据来自哪里以及已知的数据质量问题。注明延迟要求——看板需要实时数据,还是每日刷新就足够?
  7. 设置权限与访问:确定谁能看什么。部分指标可能需要受限访问。同时考虑安全要求与组织内部因素。

输出格式

使用 references/TEMPLATE.md 中的模板来组织输出。一份完整的规范会填满模板的每个部分:Overview;Purpose and Questions;Audience;Key Metrics;Visualization Specifications;Filters and Segments;Data Sources;Access and Permissions;Alerts and Thresholds;Acceptance Criteria;Open Questions;以及 Appendix。

质量检查清单

定稿之前,请确认:

  • 目的以“要回答的问题”表述,而不是“要构建的图表”
  • 所有指标都有清晰的定义与计算公式
  • 数据来源已识别且可访问
  • 可视化选择与所需洞察类型相匹配
  • 筛选能支持用户想要的下钻
  • 刷新频率与决策节奏相匹配

示例

完整示例见 references/EXAMPLE.md。