SuperAPI AI 工具集

exploring-scouts

智能体与模型

查看项目

更新于 10-16 03:45

技能介绍

用途:此技能帮助理解与探究某项目中 Signals scouts 的运行情况和表现,全程使用只读 MCP 工具。scout 是按自身间隔唤醒的计划智能体,查看一个 PostHog 项目,决定哪些内容值得上报,并写入 Signals 收件箱报告,或空手结束(也是有效结果)。它是 authoring-scouts(编写与调优)和 inbox-exploration(收件箱报告)的观测对应物。

主要能力:可观测六类信息——scout-config-list 查看哪些 scout 在运行、频率与姿态;scout-runs-list / -retrieve 查看逐次运行状态、摘要与报告 id;scout-scratchpad-search 查看团队持久记忆;scout-notes-list 查看人类留下的引导笔记;运行行的 emitted_report_ids / edited_report_ids 查看写了哪些报告;inbox-reports-list 查看面向用户呈现的报告。scout-project-profile-get 是让 scout 冷启动的确定性项目快照,scout 找不到东西通常源于此。

使用方式:首次询问先运行 scout-config-list 判断是否已配置。roster 只认 scout-config-list。scout-runs-list 可用 skill_name 与 skill_version 限定单个 scout,用 date_from / date_to 限定窗口,用 text 搜索摘要;limit 保持小(约 10–15)。会话日志通常超限被落盘,这是正常路径:用 call --json 取回真实 JSON,再用 jq 或脚本读取,不要手工解析,可用随附 scripts/ 重建。

适用场景:调查“我有哪些 scout / 它们在做什么”、端到端理解单个 scout、查看最近运行。

限制:项目可能未注册 scout,或全部 enabled:false,或处于 dry-run(emit 为 false,会运行推理但不写报告)。last_run_at 只是派发时间戳,不代表真正执行,权威存活信号是 scout-runs-list 中最新运行行。emitted_count 为 0 不等于“什么都没做”。scout-* 工具名若未知,可能在旧的 signals-scout-* 名下。比较运行时先按 harness_prompt_version、report_channel、skill_origin、github_guidance 分段;缺失 provenance 视为未知并排除。derived 映射缺失表示未知,不是全为 false。带 structured_output_schema 的 scout 还会记录 $scout_structured_output 事件,事件才是事实来源。具体工具参数、字段与更多细节见 references/scout-data-model.md;费用或平台信息暂未提供。