SuperAPI AI 工具集

signals-scout-feature-flags

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:审计功能开关配置与代码调用之间的接线是否一致,而非判断功能应否开启。

主要能力:通过 $feature_flag_called 事件流与 system.feature_flags 清单,检测评估量骤降(代码调用被移除或 SDK 路径断裂)、幽灵开关(对已删除或从未创建的 key 的调用)、开关编辑无法解释的响应分布漂移,以及陈旧开关、已全量发布仍在热路径检查、0% 发布或已停用但调用量高的开关债务。核心判据是「状态与流量矛盾」:流量趋势跟随产品,不算信号;流量与配置状态矛盾才算。

使用方式:先读 scratchpad、近期运行和项目画像,再用 SQL 汇总各开关调用量(如按 properties.$feature_flag 分组统计 14 天与 24 小时调用)。幽灵检测用 anti-join 与 system.feature_flags 对比,注意 LIMIT 会遗漏尾部小 key;时间窗口用 now() - INTERVAL N DAY,避免手写时间戳字面量(按项目时区解析)。发现矛盾后先用 feature-flags-activity-retrieve 查编辑记录,再决定是否生成报告;已覆盖的问题应编辑而非新建报告。

适用场景:功能开关使用中、且能采集 $feature_flag_called 事件的项目;开关未启用或事件未采集时,仅做配置侧清理检查。

限制:停用开关不会停止该事件,故评估量骤降不一定是关闭所致;开关是否实验关联需另行核对,实验相关开关归其他巡检处理;不建议删除开关,只建议先清理代码再停用;阈值与判定细节依赖事件数据质量。