SuperAPI AI 工具集

authoring-signals-scouts

智能体与模型

查看项目

更新于 10-16 03:44

技能介绍

用途:帮助用户和智能体改造 PostHog 自带的规范化 scouts,或为现有 scout 未覆盖的场景从头编写新 scout。scout 是按时唤醒的计划智能体,查看一个 PostHog 项目,判断值得呈现的内容并以 finding 形式写入 Signals 收件箱。

命名机制:scout 就是名称以 signals-scout- 开头的 LLMSkill,该前缀不可省略,否则不会被作为 scout 运行。运行框架会在项目技能中发现这些 scout,将其正文逐字加载为系统提示,并按需读取引用的参考文件。

编写前准备:先基于目标项目定位,读取项目快照(posthog:signals-scout-project-profile-get)、列出已有 scout 及其调度与配置(posthog:signals-scout-config-list)、读取最接近的规范化 scout(posthog:skill-get),并查看收件箱校准信号噪声。

构建路径:若规范化 scout 过宽或噪声大,可收窄范围、增加排除条件、重调阈值;若无覆盖,则复制最接近的规范化 scout 作为脚手架新建。仅调整运行时机或是否运行,只需改配置。

位置选择:常见路径是在项目技能库创建或编辑 signals-scout-* LLMSkill 行,并用 posthog:signals-scout-config-create 注册配置;PostHog 贡献者则直接编辑 products/signals/skills/signals-scout-*/ 下的文件并走构建、lint 和 PR 流程。基于原 scout 就地修改会标记为 diverged,从而不再接收上游改进。

编写要点:参考 scout-patterns、scout-anatomy、emit-contract、dedupe-and-memory 等文档,确定 scout 形态与正文结构。核心设计是信号与噪声的判别器,应在正文靠前明确写出。

运行配置:调度和发射行为位于 SignalScoutConfig。可设置 run_interval_minutes(30 至 43200,默认 1440)、enabled(false 暂停)、emit(默认 true;false 为试运行,只记录不写入收件箱)。

测试循环:用户无法强制同步运行,标准做法是让 scout 以较短间隔上线并发射,然后通过收件箱列表、运行列表与检索、笔记板搜索检查其行为,再迭代正文,稳定后恢复可持续的间隔。

质量基线:具备廉价且明确的判别器、快速结束路径、2 至 4 个具体探索模式、排除条件、按发射契约校准的决策(置信度 ≥ 0.65 才发射,否则写记忆)、利用笔记板前缀的记忆指引,以及精简正文。

限制:无法以用户身份强制同步运行;基于原行修改会导致 diverged;具体的技能存储调用、构建与 lint 命令、播种细节需参阅参考文档,当前资料未完整给出。