SuperAPI AI 工具集

external-research

写作与研究

查看项目

更新于 10-15 20:32

技能介绍

用途:当任务涉及外部库或框架、需要在写代码前确认当前 API 用法时使用,确保采用最新且正确的 API 模式,而非过时的训练数据。

主要能力:按“包 + 主题”获取并缓存文档。开头需声明:"I'm using the external-scout skill to fetch current docs for [package]." 命令为 /external-scout <package> <topic>,例如 /external-scout drizzle schemas、/external-scout react hooks、/external-scout express middleware、/external-scout zod validation。返回 JSON,包含状态、包名、主题、是否缓存命中、缓存文件路径及元数据(缓存时间、来源 context7、新鲜度)。

使用方式:先调用命令获取文档;检查返回的 JSON 与缓存状态(fresh 表示小于 7 天,直接用缓存;stale 表示超过 7 天,会自动重新拉取);读取返回文件(如 .tmp/external-context/drizzle/schemas.md);依据文档核对 API 签名、遵循当前模式、检查弃用项、使用新特性;最后按已验证模式实现。缓存位于 .tmp/external-context/,按包与主题组织,含 .metadata.json 与各主题 md 文件,7 天后自动刷新。

错误处理:拉取失败时检查网络、稍后重试或改用手动查官方文档;缓存过期重新拉取属正常;Context7 找不到该包时,查阅官方文档、npm/PyPI README 或 GitHub 仓库。

限制与注意:文档源为 Context7,缓存有效期 7 天;应在写代码前加载外部文档;以当前文档为准而非训练数据假设;相关技能为 context-discovery 与 code-execution;任务命令形式为:Fetch external documentation for: $ARGUMENTS。