核心用法
Analytics Audit Skill 是一款面向 Web 项目的 Google Analytics 实施健康检查工具。它通过扫描代码库中的 gtag、dataLayer、Measurement ID 等标识，系统化识别现有分析方案的配置状态。
执行流程分为三步：
1. 探测阶段：自动识别 GA4 (G-)、GTM (GTM-)、已弃用的 Universal Analytics (UA-) 及 Mixpanel、Amplitude 等第三方方案
2. 诊断阶段：检测 10 类常见问题，包括硬编码 ID、SPA 页面浏览缺失、TypeScript 类型缺失、调试模式残留生产环境等
3. 报告阶段：生成结构化 Markdown 报告，按 🔴 Critical / 🟡 Warning / 🟢 Suggestion 三级优先级排序修复建议
显著优点
- 时效性预警：主动识别 2024 年 7 月已停止服务的 Universal Analytics 属性，避免数据采集中断
- 安全合规导向：强制要求对 Measurement ID 进行脱敏处理（隐藏后 6 位），并检查 consent mode 隐私合规实现
- 框架感知：自动检测 React/Vue/Next.js 等框架，针对 SPA 场景提示页面浏览跟踪方案
- 可执行性强：每项建议附带具体代码修复方向，如环境变量迁移、异步加载、错误边界包装等
潜在局限
- 静态分析边界：无法验证实际运行时数据是否到达 Google 服务器（需配合 GA Debugger 浏览器扩展）
- 定制化事件盲区：对业务自定义事件的语义理解有限，建议列表基于通用场景（注册/购买/表单），需人工补充行业特定事件
- 隐私法规深度不足：提及 consent mode 但未覆盖 GDPR/CCPA 完整合规审计，需法律团队二次确认
适合人群
- 前端工程师：在代码审查阶段快速拦截 Analytics 反模式
- 技术产品经理：评估现有数据埋点覆盖率，识别决策盲区
- 运维/安全团队：排查生产环境调试配置泄露、硬编码密钥等安全隐患
常规风险
- 误报可能：合法使用的 analytics 包装库可能被标记为"第三方"，需人工复核
- 敏感信息残留：虽然工具提示脱敏，但若代码历史包含未清理的明文 ID，版本控制中仍可追溯
- 过度依赖工具：修复建议优先级为通用启发式规则，关键业务指标（如电商 purchase 事件）的缺失需结合业务上下文判断