measure-dashboard-requirements

仪表板需求

仪表板需求文档会说明仪表板应回答哪些问题、展示哪些指标，以及应如何可视化数据。明确的需求有助于数据团队构建真正能为决策提供依据的仪表板，而不只是展示数字。

适用场景

• 向数据／分析团队申请新建仪表板时
• 为产品、功能或团队定义 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 中的模板来组织输出。完整的规格说明应填写模板中的每个部分：概述；目的和问题；受众；关键指标；可视化规范；筛选器和细分；数据来源；访问权限；警报和阈值；验收标准；待解决问题；以及附录。

质量检查清单

定稿前，请确认：

• 目的以待回答的问题来表述，而非要制作的图表
• 所有指标都有明确的定义和计算公式
• 已明确数据来源，且这些来源可访问
• 可视化选择与所需的洞察类型相符
• 筛选器支持用户所需的下钻方式
• 刷新频率符合决策节奏

示例

请参阅 references/EXAMPLE.md 中的完整示例。