用途:GTM Fix Guide 是一个调试类技能,用于在 GTM 测试失败后,把测试结果转换为开发者可直接执行的修复指南。它面向会写代码但不熟悉 Google Tag Manager 的开发者,目标是让人不看 GTM 专业资料也能按步骤修复。
主要能力:读取项目根目录的 gtm-test-results.json,统计总测试数、通过数与失败数;逐条诊断失败类型,如 dataLayer 事件缺失、参数缺失、事件名不符、触发器未触发、标签未出现在网络请求、事件重复触发、参数值为空等;为每个失败给出可能原因、修复选项和验证方法,并评估工作量(低/中/高)。
使用方式:先确保存在 gtm-test-results.json,否则技能会提示先运行 gtm-testing 生成结果后停止。运行后写出 gtm-fix-guide.md,结构包括摘要表与逐条修复说明。每条修复通常给出两类路径:修改代码(添加 dataLayer.push)或在 GTM 界面调整触发器/事件名,并说明如何用 Chrome 开发者工具控制台输入 dataLayer 验证,最后建议重新运行 gtm-testing 确认。若全部通过则提示无需修复。
适用场景:网站已接入 GTM 并运行过自动化测试,出现失败需要定位与修复时;适合把排查结果交给不熟悉 GTM 的开发者。
限制:该技能只读写本地文件,不调用 API,也不修改任何 GTM 配置;诊断基于测试结果中的错误信息和测试名,若 JSON 无错误详情,只能给出通用排查步骤;具体文件路径、触发器等细节依赖项目实际内容,资料中未提供具体项目信息。