用途:为 Web(React/Next.js)和移动端(React Native/Expo)应用提供产品分析与 RUM(真实用户监控)事件埋点指导,覆盖该采集什么、该舍弃什么、何为 PII,以及如何在不破坏下游看板的前提下增删与审计埋点。
模式:技能解析参数 $1 作为模式,并先声明检测到的模式。guide(默认,判断是否值得追踪)、implement(添加埋点)、audit(审计现有埋点)、remove(移除/废弃事件)、plan(设计事件 schema 与埋点计划)。若 $1 是文件或目录,则作为 audit / implement / remove 的范围。
主要能力:事件命名与属性设计(what-to-track、what-not-to-track、event-design),PII 与合规检查,追踪计划结构,按平台给出实现规则(Web、移动端),OpenTelemetry 语义约定支持,审计清单,更新与移除生命周期,以及 analytics wrapper、追踪计划 YAML 等模板。
使用方式:按模式按需加载规则与参考文件,不预先加载。所有埋点调用必须经过集中包装器(templates/analytics-wrapper.template.ts),不得在组件中直接调用厂商 SDK。事件需先进入追踪计划再写代码。实现与移除需在同一 diff 中更新追踪计划。
限制:rules/otel-conventions.md 依赖外部 otel-instrumentation 与 otel-semantic-conventions 技能,它们位于 dash0 agent-skills 仓库而非本仓库,需另行安装才能获得权威的 span/metric/attribute 指导,否则运行时跳过并给出一行报告。
核心原则:追踪计划是唯一真源;集中式包装器;类型安全事件(可用 Avo、RudderTyper、Typewriter 或手写 discriminated union);属性中不得出现 PII;事件名低基数、属性丰富且有界;采样放到管道层而非 SDK;遵循 OpenTelemetry 语义约定;移除埋点与添加同样规范。审计结果需给出文件路径与行号,并按阻塞、重要、可选分级。价格、收费与具体效果资料暂未提供。