SuperAPI AI 工具集

signals-scout-web-vitals

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:这是 PostHog AI 插件里的一个 Core Web Vitals 侦察技能,围绕 $web_vitals 事件工作。它按 Google 固定阈值评估每个页面的 p75 指标,找出长期偏慢或近期退化的页面,并直接通过报告通道(scout-emit-report / scout-edit-report)撰写报告,报告需包含指标、档位、可能原因与修复建议。

主要能力:覆盖四个指标——LCP(≤2500 良好,2500–4000 需改进,>4000 差)、INP(≤200 / 200–500 / >500)、CLS(≤0.1 / 0.1–0.25 / >0.25)、FCP(≤1800 / 1800–3000 / >3000),无 TTFB。可识别长期 poor 页面、跨档退化、档内恶化、全站同步变化、低样本噪声,以及高流量页面的 needs-improvement 机会。支持按设备拆分候选页面,并可用 FCP↔LCP 差距、CLS 与 INP attribution 辅助推断原因。

使用方式:先做冷启动读取(scratchpad、runs、project profile、inbox),确认 $web_vitals 是否开启;用 SQL 按 host+path 分组计算 p75 并做样本量门槛(如 samples_7d >= 1000)。查询中必须对 $host、$pathname 等遥测字段做 SQL 层清洗与长度截断,避免注入内容进入上下文或报告。历史读取器不可用时跳过相关检查,不重试或绕过。

适用场景:高流量页面性能监控、发布后性能回归定位、移动端专项性能问题排查、首次运行时的性能机会提示。

限制:$web_vitals 为可选采集,缺失属配置问题而非健康问题;top_events 仅覆盖约 50 个事件,需用 count 确认;低样本 p75 不可靠;needs-improvement 机会每区域只报一次;每次运行最多一份机会报告;历史读取器可能不可用。具体报告字段、状态映射与去重规则由 harness 提示提供,本资料未展开。