用途:本技能是 PostHog Signals scouts 的操作手册。scout 是按自身间隔唤醒、查看一个 PostHog 项目、把发现作为报告写入 Signals 收件箱或空关闭的计划型智能体。它用于委派监控工作、处理返回结果,并引导 scout 团队收敛到团队真正关心的内容。
主要能力与用法:
- 确认团队是否在运行:用 posthog:scout-metadata-get 查项目是否已注册运行 scouts,用 posthog:scout-config-list 查名册(每行含 schedule、enabled、emit、description)。先查注册状态,因为配置行会比注册存活更久。scout 工具近期由 signals-scout-* 改名为 scout-*,旧名仍可尝试。scout 行位于项目的规范父级,仅限子环境的凭据会返回 403。
- 检查可写性:posthog:scout-project-profile-get 的 summary.emit_eligibility,can_emit 为 false 时 scout 写入无法到达收件箱;blocking_reason 可为 ai_processing_not_approved、source_disabled 或 scout_emit_disabled。
- 工作循环:委派、接收、处理、反馈、校准。报告不应搁置,无人处理的收件箱会导致 scout 被警告并暂停(pause_reason=ignored,Slack 投递的 scout 除外)。
- 委派:优先用最省成本的路径。已有规范 scout 覆盖则确认启用并可留笔记;需要临时焦点可留笔记(可带 expires_at);结构性缺失可用 authoring-scouts 调整或新建自定义 scout(posthog:scout-create);一次性问题直接查询数据,不用 scout。
- 处理报告:先验证再实施,scout 报告是 LLM 诊断而非事实。以真实状态关闭报告:resolved、suppressed、potential。dismissal_note 会转发给 scout 作为后续运行的上下文,但转发是尽力而为,需 scout-steering(skill-editor)权限,子环境报告不转发,笔记约 30 天后过期。
- 检查:报告解决后 scout 或流水线会附加 check,默认 24 小时浸泡窗口后重新测量,失败会生成新报告。check 只能由 scout 运行和流水线写入。
- 路由:scout 可设置 suggested_reviewers,按 user_uuid 或 github_login 路由。
- 审计:持有 write_scopes 的 scout 会改动真实对象,改动进入项目活动日志,带 scout:<skill_name> 标签。可用 posthog:scout-runs-retrieve 读取运行信息,核对 close-out。
限制:资料未提供具体价格、平台支持范围或效果保证。部分工具名、权限与转发行为以资料所述为准,缺失事实暂未提供。