用途
ga4-audit 是一个 GA4 分析审计技能，面向需要对某个 GA4 媒体资源进行数据分析审计的场景。技能扮演分析专家角色：拉取 GA4 中的结构化表现数据，对转化事件分类，评估数据质量，产出可机器读取的性能画像，为下游实验规划和 ICE 评分校准提供输入。
主要能力
- 通过 GA4 Data API（首选）或 analytics-mcp（后备）接入数据，不依赖网页调研。
- 拉取事件清单及事件数、转化数，并做三层分类：GA4 中标记的转化事件（关键事件，置信度最高）、启发式分类、L0 定义。
- 事件活跃度与死绑定审计：将窗口内计数为零的已配置或关键事件标记为 dead；开启对比时，对主周期与对比周期计数做差，标记由有到无（dark）或由无到有/大幅跃升（spiked）的事件，汇总进 measurement_integrity_flags，用于必需的测量完整性正文段落。
- 周期对比：默认计算等长的前一周期，产出趋势字段；可用 --no-compare 跳过。
- 子属性范围过滤：通过 --scope-page-contains 对 pagePath 做包含匹配，通过 --scope-host 对 hostName 做精确匹配，两者可组合为 andGroup。
- 双模式输出：传统模式下写入 .claude/context/performance-profile.md；知识库模式下按绑定类型技能写入 reference/cro-{scope}/ 下的 silver-performance-analysis 类型产物，并带知识库 frontmatter 与校验步骤。
使用方式
调用形式包括：
/ga4-audit /ga4-audit <property_id> /ga4-audit <property_id> --days 30 /ga4-audit <property_id> --days 90 --no-compare /ga4-audit <property_id> --date-range "2025-11-01:2026-01-31"
主要参数：--days 默认 90；--date-range 使用 YYYY-MM-DD:YYYY-MM-DD 格式并覆盖 --days；--no-compare 跳过对比；--scope-page-contains 与 --scope-host 限定子属性范围；--scope 仅用于知识库模式，指定写入的知识库范围；--no-kb 强制传统输出。未提供 property_id 时会检查 company-identity.md 中保存的 ga4_property 值。
前置条件：需具备 GA4 API 凭据（ga4_client.py + .env.example 配置）或已认证的 analytics-mcp；需要有效的 GA4 媒体资源 ID。若两者均不可用或资源在日期范围内无数据，技能会以对应错误信息退出。运行预算约 50-80K tokens，运行时约 5-8 分钟，单智能体。
适用场景
适合在开展转化率优化实验前，对 GA4 媒体资源做一次结构化的流量与转化表现摸底，并检查事件追踪是否正常（死绑定、零交叉）。也适合需要按页面路径或主机名拆分分析的子属性场景。
限制
分析结果会整体覆盖上次输出，不做增量合并；知识库模式下若 --scope 缺失或无效会硬性停止。技能不产出的数据导出类依赖不会被虚构。具体事件启发式规则、输出字段细节与校验脚本路径以技能文档为准，资料未完整覆盖的部分暂未提供。