用途
该技能面向产品遥测工程师,目标是在产品功能上线、变更或移除时,判断其对埋点追踪的影响并加以应用,从而保持追踪计划与产品演进一致。
主要能力
- 评估新功能是否需要新增追踪事件,或是否应扩展现有事件属性,或无需改动。
- 为新增事件设计命名、分类、属性、预期频率与分组层级。
- 对修改事件评估破坏性影响,并给出相应处理方式(如新增可选属性、版本升级、弃用期等)。
- 对移除功能标记相关事件为弃用,设置移除时间与迁移路径。
- 支持批量处理多个功能变更,合并为一次版本升级与一条变更日志。
- 输出更新后的 .telemetry/tracking-plan.yaml、.telemetry/delta.md 与 .telemetry/changelog.md。
- 在 delta 中记录实现位置(代码文件与函数/处理器)及事件调用内容,为后续代码生成提供路线图。
使用方式
前置条件:
- 必须存在 .telemetry/tracking-plan.yaml,否则应停止并提示用户先运行 product-tracking-design-tracking-plan 技能创建初始计划。
- 建议存在 .telemetry/product.md,用于校准追踪强度;若缺失可继续但需注明上下文缺口。
触发场景包括:新功能上线、现有功能变更、功能移除、审计发现修复、周期性审查。
流程:
- 理解变更:询问功能内容、关键用户动作、属于核心价值还是支持功能,或直接读取 PR/提交/功能规格。
- 评估追踪需求:判断是否引入新价值、是否扩展现有流程、是核心还是支持功能;使用极简测试“是否有人会单独查询此事件”。
- 设计迷你增量:新增事件遵循命名规范(object.action、snake_case),分配分类、定义属性类型、设置预期频率与分组层级;修改事件评估破坏性;弃用事件标记原因与移除日期。
- 对照现有事件:优先考虑扩展现有事件而非创建近似重复事件。
- 更新计划:修改 tracking-plan.yaml,添加或弃用事件,并升级 meta.version 与 meta.updated。
- 更新变更日志:追加到 changelog.md,包含 Added、Changed、Deprecated、Migration Notes。
- 更新 delta:若存在则追加,否则创建。
- 记录实现位置:在 delta 中记录代码位置、事件调用内容、身份或分组调用是否需要更新。
版本管理采用语义化版本:主版本用于破坏性变更,次版本用于新增事件或可选属性,修订版本用于文档修正。
每次更新后生成摘要,包含版本变化、日期、原因、变更列表、所需实现步骤、破坏性变更,并建议运行 product-tracking-implement-tracking 技能重新生成代码。
适用场景
- 产品功能上线、变更或下线时更新追踪计划。
- 根据审计结果修复追踪问题。
- 周期性检查过时事件与覆盖缺口。
- 冲刺结束时批量处理多个功能变更。
限制
- 必须已有 tracking-plan.yaml,否则无法执行。
- 不直接生成代码,代码生成由 product-tracking-implement-tracking 技能完成。
- 对于 B2C 产品无分组层级时,跳过分组层级分配,事件仅为用户级。
- 具体收费、价格、平台支持等信息暂未提供。