SuperAPI AI 工具集

product-tracking-design-tracking-plan

数据与分析

查看项目

更新于 10-15 09:54

技能介绍

用途

该技能扮演产品遥测工程师角色,负责设计目标追踪方案(target tracking plan),并生成从当前埋点状态到目标状态的显式差异(delta)。目标方案描述理想状态下应追踪什么事件、携带什么属性、遵循什么命名约定;差异方案则是从现状到目标的实现待办清单,明确需要新增、删除、重命名和修改的内容。

主要能力

  • 基于产品模型(.telemetry/product.md)设计事件分类,覆盖生命周期、核心价值、协作、配置、计费、导航等类别。
  • 设计事件属性,区分必填与可选属性,规定类型、枚举和命名规则(snake_case、_id、type、count、is、has* 等)。
  • 设计实体特征(traits),涵盖快照指标、生命周期日期、分类信息和 PII,并规定更新模式(一次性、变更时、定时同步)。
  • 定义分组层级(group hierarchy),支持 account、workspace、project 等嵌套结构,并指定 group() 调用触发点。
  • 为每个事件分配最具体的分组层级,便于分析工具自动汇总。
  • 校验覆盖度,检查生命周期、核心价值、协作、配置、计费、分组层级等是否完整。
  • 检查反模式与成本,避免 PII 进入事件属性、高频噪声、冗余事件、实现类事件、投机性事件,并建议用属性替代事件变体、避免全量页面浏览追踪。
  • 生成差异方案,输出新增、删除、重命名、保留、修改五类变更表格。

使用方式

前置条件:需要 .telemetry/product.md(必需),若不存在则需先运行 product-tracking-model-product 技能构建产品模型;.telemetry/current-state.yaml(推荐),若不存在则只能产出目标方案,差异方案需先运行 product-tracking-audit-current-tracking 技能完成审计。

设计流程包括:加载上下文、收集上下文(继承上游产物,避免重复询问)、选择起点(可选用 assets/ 下的分类模板,如 b2b-saas-core.yaml、ai-ml-tools.yaml、developer-tools.yaml 等)、按类别设计事件、设计属性、设计实体特征、定义分组层级、分配事件分组层级、校验覆盖度、检查反模式与成本、产出差异。

输出文件:.telemetry/tracking-plan.yaml(目标方案)和 .telemetry/delta.md(现状到目标的差异)。输出结构遵循 assets/tracking-plan-schema.yaml。

设计过程中需确认的关键决策包括:分析目标平台(如 Accoil、Amplitude、Mixpanel、Segment 等)、命名约定(默认 snake_case object.action)、PII 政策(none / traits_only / allowed)、内部用户排除策略(按角色、按邮箱域名、按标记或不排除)。这些决策记录在追踪方案的 meta 块中。

适用场景

适用于需要系统化规划产品分析埋点的团队,尤其是 B2B SaaS、AI/ML 工具、表单/问卷产品、开发者工具(API/SDK/CLI)、安全与合规产品、协作工具、分析平台等。也适用于运行在 Atlassian Forge 平台上的产品(需使用 cloudId 作为顶层分组 ID)。

限制

  • 缺少 .telemetry/product.md 时无法开始设计。
  • 缺少 .telemetry/current-state.yaml 时只能产出目标方案,无法生成差异方案。
  • 命名约定变更属于破坏性变更,需用户自行权衡现有仪表盘与一致性之间的取舍。
  • 部分分析平台存在约束,例如 Accoil 不存储事件属性、不携带分组上下文;Amplitude 和 GA4 对分组支持有限。
  • 具体收费、价格、平台效果等信息暂未提供。