SuperAPI AI 工具集

signals-scout-insight-alerts

数据与分析

查看项目

更新于 10-16 03:45

技能介绍

该工具是 PostHog AI 插件中的信号侦察器,专注于项目自身已配置的洞察告警(用户设置的阈值与异常检测告警)的触发记录。团队在创建告警时已决定哪些指标值得关注,因此它的职责不是检测异常,而是读取近期触发历史、抑制噪音,并每天告知人类最可能被漏掉的少数触发。

主要能力与用法:先通过 alerts-list 做廉价分诊,读取每个告警的 state、enabled、snoozed_until、last_notified_at、last_checked_at、last_value 及阈值/检测器配置,缩小候选范围。仅保留启用、未静音且符合以下之一的告警:state 为 Firing、state 为 Errored(静默失去评估能力)、或 last_notified_at/last_checked_at 落在回看窗口内。随后对每个候选用 alert-get(checks_date_from=-24h,可放宽至 -48h/-7d,历史保留 14 天)深读真实触发片段,关注是否通知、是否被 agent 抑制、是否持续 Firing、是否持续 Errored。需要用 insight-get 判断指标的实际含义。

判断标准为 遗漏度×重要性×持续性:未被通知(无 notification_sent_at、targets_notified 为空、无订阅用户,或 notification_suppressed_by_agent 为 true)的触发价值最高;计算值超出阈值边界越多或异常分越高越重要;跨连续检查持续 Firing 高于已自愈的单次抖动。

使用报告通道 scout-emit-report / scout-edit-report 直接撰写报告,每个发现单独负责。已报告的仍开启触发应编辑(append_evidence)而非新建;每次运行最多约 5 份报告,按严重程度排序;未被报告覆盖的可写入。已静音/禁用、抖动、已通知并已解决、低计数噪音序列上的边缘越界、开发/测试/内部告警、单次瞬时错误均应跳过。限制方面:不检测异常、不修复代码;报告需附带触发洞察图表;机制细节位于 harness 提示与 authoring-scouts 的 report-contract.md。