用途:当任务涉及外部库或包,且写代码前需要当前 API 文档时使用。该技能负责获取并缓存外部库、框架的最新文档,确保使用正确的当前 API 模式,而非过时的训练数据。
主要能力:以包名和主题请求文档,例如 /external-scout drizzle schemas、/external-scout react hooks、/external-scout express middleware、/external-scout zod validation。返回 JSON,包含状态、包名、主题、是否命中缓存、缓存文件路径及元数据(缓存时间、来源、新旧程度)。缓存状态分为 fresh(少于 7 天,直接使用)和 stale(超过 7 天,自动重新获取)。缓存文件存放在 .tmp/external-context/ 下,按包组织,例如 drizzle/ 目录含 .metadata.json、schemas.md、queries.md。缓存文件在 7 天后自动刷新。
使用方式:先调用 /external-scout <package> <topic>;检查返回的 JSON 与缓存路径;读取返回的缓存文档文件(如 .tmp/external-context/drizzle/schemas.md);用文档核对 API 签名、遵循当前模式、检查废弃项、使用训练后新增的功能;最后按经验证的文档实现。
适用场景:需要写基于外部库的代码前,尤其是在 API 可能已变化时,用其替代对训练数据的假设。
限制:资料显示 fetch 失败时可检查网络连接、稍后重试或手动访问官方文档;若 Context7 中找不到该包,需访问官方文档、查看 npm/PyPI 的 README 或 GitHub 仓库 API 文档。其他费用、平台支持等信息暂未提供。