SuperAPI AI 工具集

signals-scout-inbox-validation

通用与其它

查看项目

更新于 10-16 08:07

技能介绍

用途:该技能是 PostHog 信号体系的后续侦察环节。其他侦察与信号源负责发现问题,团队合并修复后,它负责闭环验证:问题是否真的停止。它不检测新问题,只对被标记为已解决(resolved)的报告所声称的修复进行复测。

主要能力:

  1. 为新近转为已解决(通常由关联实现 PR 合并自动触发,偶有回填)的报告附加校验检查(check)。先通过 inbox-reports-list 与 inbox-reports-retrieve 获取报告标题、摘要、指标与 pull_requests,并尽量取 PR 真实合并时间作为观察窗起点;无部署遥测,故以观察窗(默认不早于合并后 24 小时,客户端或移动端可延长至 72 小时以上)作为代理。
  2. 从报告指标与贡献信号中推导“必须保持为真”的期望,测量修复前基线,再创建 metric_threshold 或 agent 类型检查,设置比较方式与 next_run_at,不设 run_interval_minutes。
  3. 被派发回答某个检查时,运行探针阶梯并只记录一个结论(passed/failed/inconclusive/errored)。
  4. 在本轮预算内对已过观察窗的已解决修复做最多 2 个抽查,复核检查判定是否成立,发现矛盾则记录 spotcheck-disagree:。

使用方式:按调度运行时会先读取 scout-scratchpad-search 与 scout-runs-list 了解历史,再列出 resolved 报告(limit 20,必要时翻页),每轮最多附加约 5 个检查;被派发运行则跳过队列只处理指定 check_id。检查失败通常应撰写一份新的报告并引用原已解决报告,而不是在原报告上追加备注,因为 edit_report 无法改变状态。

限制:无部署遥测,观察窗只是近似;不可测量的报告(文档改动、流程建议、一次性数据修正)不应硬造阈值,应记录不可验证;报告超过 14 天的历史属积压不处理。资料未提供收费、价格、支持平台等其余信息。