authoring-scouts

用途：帮助用户与智能体把 PostHog 官方的 canonical scouts（跨产品通用型加各产品面专家型）改造适配到具体项目，或为官方未覆盖的场景从零编写新 scout。scout 是按自身周期自动唤醒的调度型智能体，只观察一个 PostHog 项目，判断哪些发现真正值得上报，并作为报告写入 Signals 收件箱，也可以空跑关闭——空跑是有效结果。 主要能力与概念：scout 本质是携带 SignalScoutConfig 的 LLMSkill，主体内容被原样加载为系统提示词，并可按需渐进读取随附参考文件。报告型 scout 在 frontmatter 的 allowed_tools 中列入 emit_report / edit_report，大多数官方 scout 及所有新建报告型 scout 都应如此；输出到产品界面的 scout 则省略这两个工具。输出落点由配置的 output_destinations 决定，报告进收件箱的同时也可投递到 Slack 频道或私信。 用法路径：先读项目快照、查看已运行的 scout、读取最接近的官方 scout 作为模板、浏览收件箱以校准信噪比。可选择改造官方 scout、从零新建、私下做对比试验，或仅调整 config、留备注。常见用户路径是用 scout-create 创建可运行的 scout，再用 skill-update / -file-create 改提示词或文件，用 scout-config-update 调运行参数。配置项包括 run_interval_minutes（30–43200，默认 1440）、run_cron_schedule、enabled、precheck_query、emit（默认 true，false 为 dry-run）、network_access 等。 设计要点与限制：正文只写 scout 观察什么、如何判断，不写发布状态、待办、仅属于某项目的具体事实，也不重复 harness 机制。正文中需显式命名信噪比判别器。带写入权限的 maintainer/steward 模式可让 scout 自行维护仪表盘、告警等。资料未提供具体收费、价格与效果数据。