用途:这是 PostHog AI 插件中的 surveys 侦察技能,负责两件事:一是对活跃问卷做异常监控,包括评分回归(NPS/CSAT/评分下降)、回复量下降、放弃率飙升(dismissed 占 shown 比例上升)和定向漂移(曝光量远高于或低于基线);二是对开放文本回复做主题聚合,把受访者实际在说的内容聚类,例如在团队察觉前发现“上周有五位不同用户抱怨同一个结账步骤”。
主要能力:通过 scout-emit-report / scout-edit-report 直接撰写报告,作者对每份报告端到端负责;使用 scout-scratchpad-search、scout-runs-list、inbox-reports-list、scout-project-profile-get 做冷启动定位;用 surveys-global-stats 做项目级检查,用 execute-sql 按近 30 天 survey sent 量排序候选问卷,再对前 5–10 个 id 调用 survey-get 与 survey-stats;支持按 $survey_iteration 比较循环问卷各轮次的主题与评分基线。
使用方式:先判断问卷是否活跃——若 surveys-get-all(archived: false)返回空且 surveys-global-stats 近 30 天为零事件,则写一条 scratchpad 条目 not-in-use:surveys:team{team_id} 并空关闭。评分回归采用分层门槛:高量问卷(基线≥30/周)要求近一周≥30 且评分下降≥量表 10%;低量问卷(5–30/周)要求近 14 天≥8 且下降≥15%,对比自身 60 天基线;极低量(<5/周)只做主题聚合。主题报告门槛为 14 天内≥5 位不同受访者收敛,或≥3 位且与同期活动日志(部署、开关、新功能)吻合。
限制:活动历史为可选能力,读取器不可用或被拒时本轮停止使用该读取器,不重试、不绕过、不提交缺失工具报告,并在收尾注明。问卷属个人数据,错误报告影响大,存疑时写记忆条目而非提交报告;inbox 已覆盖的主题或回归应做编辑而非新报告。评分查询需处理 id 与旧索引两套属性键并做 $survey_submission_id 去重。widget 与 api 类型问卷的 dismiss 率基线天然偏高,仅在伴随回复量下降时才视为信号。具体命令、SQL 与配置字段以官方资料为准,本文未提供完整代码示例。