/metrics-track

为项目制定指标追踪计划。基于精益创业（Lean Startup）原则，定义 PostHog 事件漏斗、关键绩效指标（KPI）基准，以及“终止/迭代/规模化”的决策阈值。

MCP 工具（如有可用）

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

若 MCP 工具不可用，则回退至 Grep + Read 方式。

方法论参考

本技能依据精益创业原则实施指标追踪：

• 相对指标 vs 垂直领域基准 — 与自身历史轨迹对比，而非与虚荣平均值比较
• “终止/迭代/规模化”决策规则 — 基于数据的明确阈值支撑产品决策（参见下方第 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
   

   映射为具体事件：

   阶段	事件名称	触发条件	属性
   Awareness	page_viewed	访问落地页	source, utm_*
   Acquisition	app_installed 或 signed_up	首次安装 / 注册	platform, source
   Activation	core_action_completed	完成首个核心操作	feature, duration_ms
   Revenue	purchase_completed	完成首笔支付	plan, amount, currency
   Retention	session_started	回访（D1/D7/D30）	session_number, days_since_install
   Referral	invite_sent	发起分享或邀请	channel, referral_code

5. 强制推理 — 指标筛选：
   在定义 KPI 前，请明确写出：

   • 北极星指标（North Star Metric）：最关键的单一指标（例如：“完成核心操作的周活跃用户数”）
   • 领先性指标（Leading indicators）：可预测北极星指标的信号（例如：“首日激活率 D1”）
   • 滞后性指标（Lagging indicators）：验证成功与否的结果（例如：“MRR”、“30 日留存率 D30”）
   • 应避免的虚荣指标（Vanity metrics）：（例如：“总下载量”，但未关联激活行为）

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

   KPI	目标值	终止阈值	规模化阈值	来源
   Landing → Signup	3–5%	< 1%	> 8%	行业均值
   Signup → Activation	20–40%	< 10%	> 50%	产品内部基准
   D1 Retention	25–40%	< 15%	> 50%	移动应用均值
   D7 Retention	10–20%	< 5%	> 25%	移动应用均值
   D30 Retention	5–10%	< 2%	> 15%	移动应用均值
   Trial → Paid	2–5%	< 1%	> 8%	SaaS 行业均值

   请根据产品类型（B2C vs B2B、免费 vs 付费、移动端 vs Web 端）调整阈值。

7. 定义决策规则（精益创业“终止/迭代/规模化”框架）：

   ## 决策框架
   
   **评审频率：** 每周一次（周五）
   
   ### 终止（KILL）信号（满足任意两项即终止）
   - [ ] 激活率连续 2 周低于 {kill_threshold}
   - [ ] 30 日内 D7 留存率持续低于 {kill_threshold}
   - [ ] 分发启动后连续 2 周无自然注册用户
   - [ ] CAC 超过预估 LTV 的 3 倍
   
   ### 迭代（ITERATE）信号
   - [ ] 各项指标处于终止阈值与规模化阈值之间
   - [ ] 定性反馈表明存在产品-市场匹配（PMF）问题
   - [ ] 漏斗中某一环节表现显著劣于其他环节
   
   ### 规模化（SCALE）信号（需同时满足全部三项）
   - [ ] 激活率高于 {scale_threshold}
   - [ ] D7 留存率高于 {scale_threshold}
   - [ ] 自然增长率达周环比 >10%
   

8. 生成 PostHog 实现代码片段：

   iOS（Swift）：

   // 事件追踪示例
   PostHogSDK.shared.capture("core_action_completed", properties: [
       "feature": "scan_receipt",
       "duration_ms": elapsed
   ])
   

   Web（TypeScript）：

   // 事件追踪示例
   posthog.capture('signed_up', {
       source: searchParams.get('utm_source') ?? 'direct',
       plan: 'free'
   })
   

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

   # Metrics Plan: {Project Name}
   
   **生成时间：** {YYYY-MM-DD}
   **平台：** {iOS / Web / Both}
   **北极星指标：** {north star metric}
   
   ## 事件漏斗
   
   | 阶段 | 事件 | 属性 |
   |-------|-------|------------|
   {step 4 中的事件表格}
   
   ## KPI 与阈值
   
   | KPI | 目标值 | 终止阈值 | 规模化阈值 |
   |-----|--------|----------|-------------|
   {step 6 中的基准表格}
   
   ## 决策规则
   
   {step 7 中的框架内容}
   
   ## 实施说明
   
   ### PostHog 配置
   - Project：{project name}（EU 区域）
   - SDK：{posthog-ios / posthog-js}
   - 身份识别：初始匿名，注册时调用 identify() 并传入用户 ID
   
   ### 代码片段
   {step 8 中的代码片段}
   
   ## 仪表板模板
   - 漏斗视图：{stage1} → {stage2} → ... → {stageN}
   - 留存分析：D1 / D7 / D30 队列图表
   - 收入分析：MRR 趋势 + 免费试用转化率
   
   ---
   *由 /metrics-track 生成。请先实现事件埋点，再每周评审。*
   

10. 输出摘要 —— 北极星指标、关键阈值、首个待实现事件。

注意事项

• PostHog 使用 EU 区域托管以满足隐私合规要求
• 使用 $set 设置用户属性，使用 capture 上报事件
• 身份管理：起始为匿名状态；注册时通过 identify() 关联用户 ID
• 跨平台支持：共用同一 PostHog project 和同一用户 ID，实现用户旅程统一
• 仪表板需每周评审；“终止/迭代/规模化”决策每月执行一次

常见问题

平台识别错误

原因：项目同时包含 Web 与 iOS 标识特征。
修复方式：本技能会检查 package manifests；若两者均存在，则自动生成跨平台身份识别方案。请在输出中核实所识别的平台是否准确。

KPI 阈值过于激进

原因：默认阈值取自行业平均值。
修复方式：请根据自身垂直领域，在 docs/metrics-plan.md 中手动调整阈值。B2B 场景通常量级较低但转化率更高。

项目中未集成 PostHog SDK

原因：指标计划已生成，但 SDK 尚未安装。
修复方式：本技能仅生成指标计划（PLAN），不负责 SDK 安装。请单独完成 SDK 集成：pnpm add posthog-js（Web）或通过 SPM 添加 posthog-ios（iOS）。