用途:帮助用户和智能体把 PostHog 已有的 canonical scouts(跨产品通用型加各产品面专家型)适配到具体项目,或从零编写覆盖新场景的 scout。scout 是按固定间隔自主唤醒的计划型智能体,查看单个 PostHog 项目,判断哪些内容真正值得上报,并写入 Signals 收件箱作为报告,或以空结果关闭。
主要能力与用法:先落地于目标项目再动笔。可用 posthog:scout-project-profile-get 读取项目快照,用 posthog:read-data-schema 确认目标事件是否存在及其结构,用 posthog:scout-config-list 查看现有 scout 的调度、启用状态和上报姿态,用 posthog:skill-list 列出 canonical scout 名册,用 posthog:skill-get 拉取最接近的模板,用 posthog:inbox-reports-list 查看收件箱以校准信号与噪声。编写时参考 scout-patterns、scout-anatomy、report-contract、dedupe-and-memory、report-checks 等参考文件,选定模式后写正文。scout 是持有 SignalScoutConfig 的 LLMSkill;正文会被逐字作为系统提示加载。报告通道需在 frontmatter 的 allowed_tools 中加入 emit_report / edit_report。既可每团队创建可运行 scout(posthog:scout-create,后续用 skill-update、skill-config-update 调整),也可由 PostHog 贡献者编辑仓库中的 canonical scout。
运行配置:run_interval_minutes 范围 30 到 43200,默认 1440;run_cron_schedule 为五字段 cron,按项目时区执行;enabled 为 false 可暂停;emit 默认 true,设为 false 进入 dry-run;network_access 默认 trusted,可按需设 full;auto_pause_exempt 默认 false;write_scopes 默认空数组。
限制与注意:不要把上线状态、待办、仅项目特有事实或重复的 harness 机制写入正文;就地修改 canonical scout 会标记为 diverged 并停止接收上游更新。资料未提供更多细节。