product-analytics

Product Analytics 是一个面向产品分析场景的技能，用于在产品发现、增长和成熟阶段定义、跟踪和解读产品指标。

用途

该技能适用于以下场景：

指标框架选择（AARRR、North Star、HEART）
按产品阶段定义 KPI（pre-PMF、增长、成熟）
仪表盘设计与指标层级
队列与留存分析
功能采用与漏斗解读

主要能力

指标框架选择

AARRR：用于增长循环和漏斗可见性
North Star：用于跨职能战略对齐
HEART：用于 UX 质量和用户体验测量

按阶段定义 KPI

Pre-PMF 阶段：激活率、第 1 周留存、首次价值时间、问题-解决方案匹配访谈评分。

增长阶段：按阶段划分的漏斗转化、月度留存用户、新队列中的功能采用、扩展/追加销售代理指标。

成熟阶段：与产品指标对齐的净收入留存、高级用户占比与使用深度、按细分市场的流失风险指标、可靠性与支持分流产品指标。

仪表盘设计原则

展示趋势，而非孤立的点估计。
每个 KPI 保持一个负责人。
每个 KPI 配以目标、阈值和决策规则。
默认使用队列和细分过滤器。
优先使用可比时间窗口（周对周、月对月）。

队列分析方法

定义队列锚点事件（注册、激活、首次购买）。
定义留存行为（活跃日、关键操作、重复会话）。
按队列周/月和年龄周期构建留存矩阵。
比较不同队列的曲线形状。
标记早期流失点并调查旅程摩擦。

留存曲线解读

早期急剧下降、低平台期：引导不匹配或初始价值弱。
中度下降、稳定平台期：健康的核心受众，流失可预测。
在低水平趋于平缓：产品偶尔使用，需重新审视价值指标。
较新队列改善：引导或定位改进正在生效。

反模式与修复

虚荣指标：跟踪页面浏览量或总注册数而无激活上下文。修复：始终将获取指标与激活率和留存配对。
单点留存：报告“30 天留存为 20%”。修复：比较不同队列的留存曲线，而非孤立快照。
仪表盘过载：一屏 30+ 指标。修复：执行层 5-7 个指标；功能层仅按功能。
无决策规则：跟踪 KPI 但无阈值或行动计划。修复：每个 KPI 需要目标、阈值、负责人和“如果低于 X，则 Y”。
跨细分平均：报告混合指标掩盖细分差异。修复：始终按队列、计划层级、渠道或地理细分。
忽略季节性：比较本周与上周而不调整。修复：使用周期对比并参考去年同期。

使用方式

技能提供命令行工具 scripts/metrics_calculator.py，用于从 CSV 数据计算留存、队列和漏斗分析，支持文本和 JSON 输出。

留存分析：

python3 scripts/metrics_calculator.py retention events.csv
python3 scripts/metrics_calculator.py retention events.csv --format json

队列矩阵：

python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain month
python3 scripts/metrics_calculator.py cohort events.csv --cohort-grain week --format json

漏斗转化：

python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay
python3 scripts/metrics_calculator.py funnel funnel.csv --stages visit,signup,activate,pay --format json

留存/队列的 CSV 格式：

user_id,cohort_date,activity_date
u001,2026-01-01,2026-01-01
u001,2026-01-01,2026-01-03
u002,2026-01-02,2026-01-02

漏斗的 CSV 格式：

user_id,stage
u001,visit
u001,signup
u001,activate
u002,visit
u002,signup

适用场景

产品团队需要选择或统一指标框架时。
需要按产品阶段（pre-PMF、增长、成熟）定义 KPI 时。
需要设计执行层、产品健康层和功能层仪表盘时。
需要执行队列分析、留存分析或漏斗转化分析时。
需要解读功能采用趋势并连接产品变更与指标变化时。

限制

该技能主要提供方法论、模板和 CSV 计算工具，不包含数据采集或可视化平台集成。
工具依赖用户提供符合格式的 CSV 数据。
具体指标目标、阈值和决策规则需由使用团队根据自身业务设定。
资料未提供收费、价格、平台支持范围或效果保证等信息。