SuperAPI AI 工具集

signals-scout-feature-flags

通用与其它

查看项目

更新于 10-16 03:45

技能介绍

用途:该工具是 PostHog 的功能开关侦察器,审计开关配置界面与代码调用之间的“接线”,而非判断哪些功能该开启。

主要能力:

  1. 评估悬崖:活跃开关评估量骤降,可能因部署移除代码调用、SDK 路径损坏或整体流量崩塌。
  2. 幽灵开关:代码仍在评估已删除或不存在的键,SDK 静默返回 false/undefined。
  3. 响应分布偏移:无开关编辑时响应比例变化,可能为目标属性值变化。
  4. 开关债务:清理候选,如已全量发布仍被调用的开关、0% 发布但调用量大的活跃开关、已停用但代码检查未清理的开关。

使用方式:

  • 读取 recent_feature_flags 与最近 $feature_flag_called 计数判断开关是否在用。
  • 用 SQL 查询按 flag_key 聚合调用量、人数,识别悬崖候选与幽灵键。
  • 用 feature-flags-activity-retrieve 检查编辑活动,排除故意变更。
  • 通过 health-issues-list 读取 stale_feature_flags 活跃问题,逐一复核后生成单开关清理报告。
  • 报告通过 scout-emit-report / scout-edit-report 通道直接撰写。

适用场景:PostHog 项目中功能开关的运维审计、清理候选发现、异常评估流排查。

限制:活动历史为可选能力,不可用时应停止使用该读取器并记录。开关是否在用需先确认。报告需为局部、已验证的矛盾点,已覆盖问题仅在情况变化时编辑。无活动历史时不能排除有意编辑。缺失事实暂未提供。