solo-metrics-track

/metrics-track

为项目设置指标跟踪计划。根据精益创业原则，定义 PostHog 事件漏斗、KPI 基准，以及停止／迭代／扩展的决策阈值。

MCP 工具（如可用）

• kb_search(query) — 查找 PostHog 方法论和分析模式

如果 MCP 工具不可用，则改用 Grep + Read。

方法论参考

此技能根据精益创业原则实施指标跟踪：

• 相对指标与细分领域基准 — 与自身的发展趋势比较，而非追逐虚荣的平均值
• 停止／迭代／扩展决策规则 — 为产品决策设定数据驱动的阈值（见下文第 7 步）

步骤

1. 解析 $ARGUMENTS 中的项目。

   • 阅读 PRD，了解功能、ICP 和盈利模式。
   • 阅读 CLAUDE.md，了解技术栈（iOS／Web／两者）。
   • 如果为空：通过 AskUserQuestion 提问。

2. 检测平台：

   • iOS 应用 → PostHog iOS SDK 事件
   • Web 应用 → PostHog JS SDK 事件
   • 两者都有 → 跨平台身份（不同平台共享同一用户 ID）

3. 加载 PostHog 方法论：

   • 如果 MCP 可用：kb_search("PostHog analytics events funnel identity")
   • 否则：检查项目文档中是否已有分析配置
   • 提取：事件命名约定、身份解析和漏斗模式

4. 根据 PRD 功能定义事件漏斗：

   标准漏斗：Awareness → Acquisition → Activation → Revenue → Retention → Referral

   完整事件表、KPI 阈值、PostHog 代码片段和 A/B 测试模板见 references/kpi-benchmarks.md。根据具体产品调整事件。

5. 强制推理——指标选择： 定义 KPI 前，先写出：

   • 北极星指标： 最重要的那个指标（例如，“每周完成核心操作的活跃用户数”）
   • 领先指标： 哪些因素能预测北极星指标？（例如，“D1 激活率”）
   • 滞后指标： 哪些指标能确认成功？（例如，“MRR”、“D30 留存率”）
   • 应避免的虚荣指标：（例如，未考虑激活情况的总下载量）

6. 为各阶段设定 KPI 基准：

   以 references/kpi-benchmarks.md 中的阈值为起点。根据产品类型调整（B2B 的用户量较低、转化率较高；B2C 移动应用的用户量较高、留存率较低）。

7. 定义决策规则——使用 references/kpi-benchmarks.md 中的停止／迭代／扩展框架。根据第 6 步中针对项目设定的值调整阈值。

8. 生成 PostHog 实施代码片段——使用 references/kpi-benchmarks.md 中针对不同平台的示例。根据第 4 步定义的漏斗调整事件名称和属性。

9. A/B 测试分析模板——将 references/kpi-benchmarks.md 中的模板复制到指标计划中。包含决策规则（SHIP / KEEP / EXTEND / INCONCLUSIVE）。

10. 将指标计划写入 docs/metrics-plan.md：

# Metrics Plan: {Project Name}

**Generated:** {YYYY-MM-DD}
**Platform:** {iOS / Web / Both}
**North Star:** {north star metric}

## Event Funnel

| Stage | Event | Properties |
|-------|-------|------------|
{event table from step 4}

## KPIs & Thresholds

| KPI | Target | Kill | Scale |
|-----|--------|------|-------|
{benchmark table from step 6}

## Decision Rules

{framework from step 7}

## Implementation

### PostHog Setup
- Project: {project name} (EU region)
- SDK: {posthog-ios / posthog-js}
- Identity: {anonymous → identified on signup}

### Code Snippets
{snippets from step 8}

## A/B Test Template
{template from step 9}

## Dashboard Template
- Funnel: {stage1} → {stage2} → ... → {stageN}
- Retention: D1 / D7 / D30 cohort chart
- Revenue: MRR trend + trial conversion

---
*Generated by /metrics-track. Implement events, then review weekly.*

11. 输出摘要——北极星指标、关键阈值、要实施的第一个事件，以及是否包含 A/B 测试模板。

注意事项

• 为符合隐私要求，使用 PostHog EU 托管
• 使用 $set 设置用户属性，使用 capture 记录事件
• 身份：从匿名状态开始，注册时使用用户 ID 调用 identify()
• 跨平台：使用同一个 PostHog 项目和同一个用户 ID → 统一用户旅程
• 每周查看仪表板，每月作出停止／迭代／扩展决策

常见问题

检测到的平台有误

原因： 项目同时包含 Web 和 iOS 特征。 解决方法： 此技能会检查软件包清单。如果两者都存在，则会生成跨平台身份设置。请在输出中确认检测到的平台。

KPI 阈值过于激进

原因： 默认阈值是行业平均值。 解决方法： 根据细分领域调整 docs/metrics-plan.md 中的阈值。B2B 通常用户量较低，但转化率较高。

项目中没有 PostHog SDK

原因： 已生成指标计划，但尚未安装 SDK。 解决方法： 此技能仅生成计划。请单独安装 PostHog SDK：Web 端使用 pnpm add posthog-js，iOS 端通过 SPM 添加 posthog-ios。