用途:把工程里已有的第三方埋点 SDK 调用迁移到 AE SDK(数数 / ThinkingAI / Agentic Engine / AE SDK)。触发场景包括“把当前工程里的 xx SDK 切换到数数”“用数数替换 xx SDK”“集成数数并参考已有的 xx SDK 埋点”。仅接入数数、无源 SDK 属于新建埋点,应走 ae-generate-tracking-code;无源码、只有产品文档时应走 ae-generate-tracking-plan + ae-generate-tracking-code。历史数据导入属离线工作,不在本技能范围。
主要能力:以 provider 适配器为核心,支持 Firebase Analytics、Amplitude、神策 Sensors Data、Mixpanel、GA4 及其列出的各平台。流程分阶段:Phase 0 检测源 SDK 与版本;Phase 1 提取事件、身份、用户属性、公共属性调用点,写入 .ae-cli/migration/scan.json,并做包装层反向调用图解析;Phase 2 映射为 AE 事件与属性,写 mapping.json 与 draft.json;Phase 3 交给 ae-generate-tracking-plan 生成并上传方案;Phase 4 交给 ae-generate-tracking-code 插入 AE 代码。
使用方式:命令示例包括 ae-cli tracking plan draft --in .ae-cli/draft.json --out .ae-cli/draft.xlsx、ae-cli tracking plan validate --in .ae-cli/draft.json --fix,以及 ae-cli tracking plan upload。上传前需用户确认。
模式与限制:支持 switch(替换,删除源调用与依赖,高风险需确认)与 add(双写,保留源 SDK,AE 调用独立、各自 try/catch,不被源 SDK 守卫或异常抑制)。GA4 与 Firebase 属同一数据流,需合并为一次迁移。未列出的平台不支持,不得编造映射。输出语言须与用户输入语言一致。