| name | google-marketing-ops |
| description | 统一处理 Google Ads / Google Analytics 4 / Google Tag Manager 三件套的配置、调试、查数据、跨工具联动、周报闭环。覆盖以下场景必须触发——Ads 任何写操作或读分析（关键词、否定词、出价、预算、campaign、搜索词、质量分、Extensions、地理定向、周报、决策日志、维护计划、ads 优化）；GA 任何查询或分析（流量来源、渠道分布、Organic/Paid Search、落地页、转化、漏斗、归因、活跃用户、实时数据、property 配置）；GTM 任何配置或调试（tag、trigger、variable、container、版本发布、预览模式、埋点验证）；跨工具联动（Ads 改完怎么验、转化数据对不上、埋点发了 GA 没收到）；环境配置（google-ads.yaml、ADC 凭据、analytics-mcp 安装、GTM OAuth、新机器初始化、setup check）。也包含「Google 工具」「营销三件套」「跑一份报表」「拉一下数据」等模糊表达，只要触及 Ads/GA/GTM 任一就走本 skill。**项目特定信息（property ID、域名、文件路径等）从 `local/project-context.md` 读取，跨项目复用时无需改本仓库。** |
google-marketing-ops — Google Ads / GA / GTM 三件套统一入口
本 skill 是 Google 营销工具栈的编排层。它不重复 MCP/API 工具本身的能力描述——三个工具的原子能力由对应的 MCP/SDK 提供。本 skill 提供：
- 路由：把用户意图分发到合适的 playbook
- 组合：告诉 AI 哪些工具配合用、按什么顺序
- 分析：拿到数据后下一步怎么解读，不止于"列出原始数字"
⚠️ 触发后第一件事：读 local/project-context.md
任何任务（包括看似简单的"拉一份报表"）开始前，先读 local/project-context.md 拿到本项目的：
- GA Property ID
- 主站/副站域名
- Ads 工具仓库路径与数据缓存位置
- GTM Container ID
- 周报/维护计划/决策日志文件路径
- W 周起点
没有这个文件：跳到 playbooks/setup-check.md 引导用户从 local/project-context.md.example 复制一份并填写。不要用本 SKILL.md 里的占位符示例值（如 123456789、example.com）去调真实 API——那会失败或拿到错的账户。
有这个文件：把里面的实际值替换进 playbook 的示例代码，再调 API。
三件套能力边界（先选对工具）
| 工具 | 入口 | 读 | 写 | 何时用 |
|---|
| Google Ads | google-ads-api skill (本地 SDK + ~/.google-ads.yaml) | ✅ | ✅ | 关键词/否定词/出价/预算/campaign/搜索词/质量分 |
| GA (GA4) | mcp__analytics-mcp__* (stdio MCP, ADC 凭据) | ✅ | ❌ 只读 | 流量/渠道/落地页/转化/归因/实时活跃 |
| GTM | mcp__gtm__* (HTTP MCP, OAuth) | ✅ | ✅ | tag/trigger/variable/container/版本发布 |
关键边界：
- 改埋点 = GTM，看埋点效果 = GA。Ads 改了出价想验证转化，是 GA 的事，不是 Ads 的事（Ads 后台只看自己的转化口径，GA 才能看完整漏斗）。
- GA 不能写——想改自定义维度/受众/事件创建规则，得走 Admin API（本 skill 暂不覆盖）或 GTM。
- Measurement Protocol 是发数据，不是改配置。本 skill 不覆盖。
任务路由（决定读哪个 playbook）
按用户意图首词优先选：
| 用户说 | 读 playbook |
|---|
| "新机器 / 这台电脑 / setup / 配置 / 凭据没了 / 装一下 / 接一下 GA" | playbooks/setup-check.md |
| "加否定词 / 暂停关键词 / 改出价 / 改预算 / 新建 campaign / 加 Extensions / 改地理定向" | playbooks/ads-config.md |
| "查搜索词 / 看质量分 / 拉关键词数据 / campaign 表现 / Ads 审计 / GAQL" | playbooks/ads-analysis.md |
| "GA / 流量 / 渠道 / 落地页 / 转化漏斗 / 归因 / 实时活跃 / 拉一下报表" | playbooks/ga-analysis.md |
| "GTM / tag / trigger / variable / 容器 / 发版 / 预览 / 埋点没收到" | playbooks/gtm-debug.md |
| "Ads 改完看效果 / 转化对不上 / 埋点是否生效 / 投放联动" | playbooks/cross-tool-flows.md |
| "周报 / W数字 / 维护计划 / 决策日志 / Ads 改完闭环" | playbooks/weekly-review.md |
模糊场景：
- 任务跨 2 个以上工具 → 优先
cross-tool-flows.md
- 不确定 → 先读
setup-check.md 确认本机能用哪些工具，再回头分流
通用原则
1. 数据 ≠ 答案
每次拉数据后必须做下一步分析：归因、对比、识别异常。只列原始数字不算完成任务。每个 playbook 的最后一段都是"分析下一步"，必读。
2. 写操作必须确认
Ads / GTM 的写操作（暂停 campaign、改预算、发布 GTM 版本）必须先把 diff 给用户看，确认后再执行。GA 是只读，不存在这个问题。
3. 凭据出问题先跑 setup-check
任何工具调用失败（401/403/permission denied/credentials not found）→ 先读 setup-check.md 排查，不要直接换工具绕过。绕过会掩盖配置问题，下次还会出。
4. 跨工具数据对不上是常态
Ads 后台转化数 vs GA 转化数 vs GTM 触发数三方有差异是正常的，不要花时间凑一致。差异原因写进 cross-tool-flows.md。归因模型、采样、时区、阈值四个口径就足够解释 90% 的不一致。
5. 周报闭环不能断（如果项目采用 W 周制度）
是否启用 W 周制度，看 local/project-context.md 是否填了「W1 起点」。启用了的话，任何 Ads 写操作完成后主动提示用户走 weekly-review 闭环。
失败兜底
如果任务没匹配上面任何一个 playbook，按这个顺序：
- 先读
cross-tool-flows.md 看是否是组合任务
- 还不匹配 → 走 setup-check 验证当前可用工具
- 仍然不行 → 老老实实告诉用户"这个场景目前 skill 没覆盖"，让用户判断
不要硬套 playbook。playbook 没覆盖的场景比硬套出来的错答案更安全。
