外部文档侦察技能Skill external-scout

---

名称: external-scout 描述: 当任务涉及外部库或包，需要在编写代码前获取当前API文档时使用。 上下文: fork 代理: external-scout

外部侦察

概述

获取并缓存外部库和框架的当前文档。训练数据已过时——此技能确保您使用当前、正确的API模式。

开始时宣布: “我正在使用外部侦察技能来获取[包]的当前文档。”

过程

步骤1: 调用外部侦察

请求文档，包含包和主题：

/external-scout <包> <主题>

示例:

/external-scout drizzle schemas
/external-scout react hooks
/external-scout express middleware
/external-scout zod validation

步骤2: 检查响应

外部侦察返回JSON，包含缓存文件路径：

{
  "status": "success",
  "package": "drizzle",
  "topic": "schemas",
  "cached": true,
  "files": [
    ".tmp/external-context/drizzle/schemas.md"
  ],
  "metadata": {
    "cachedAt": "2026-02-16T10:30:00Z",
    "source": "context7",
    "age": "fresh"
  }
}

缓存状态:

• "fresh" — < 7 天旧（使用缓存）
• "stale" — > 7 天旧（自动重新获取）

步骤3: 加载缓存文档

读取返回的文件：

读取: .tmp/external-context/drizzle/schemas.md

此文件包含当前API模式、示例和最佳实践。

步骤4: 应用于实现

使用加载的文档来：

• 验证API签名是否正确
• 遵循当前模式（非训练数据）
• 检查已弃用的内容
• 使用自训练以来引入的新功能

步骤5: 自信地实现

现在您拥有当前文档，按照已验证的模式进行实现。

示例: 使用Drizzle ORM

1. 调用: /external-scout drizzle schemas

2. 响应:
   {
     "status": "success",
     "files": [".tmp/external-context/drizzle/schemas.md"]
   }

3. 加载: 读取 .tmp/external-context/drizzle/schemas.md

4. 审查: 定义表和关系的当前API

5. 实现: 使用从加载文档中获得的当前模式

缓存位置

.tmp/external-context/
├── drizzle/
│   ├── .metadata.json
│   ├── schemas.md
│   └── queries.md
├── react/
│   ├── .metadata.json
│   └── hooks.md
└── express/
    ├── .metadata.json
    └── middleware.md

缓存文件在7天后自动刷新。

错误处理

“外部文档获取失败”:

• 检查网络连接
• 几分钟后重试
• 备用方案: 手动访问官方文档

“缓存已过时，正在重新获取”:

• 正常行为——外部侦察自动获取新鲜文档

“在Context7中未找到包”:

• 访问官方包文档
• 检查npm/PyPI获取包README
• 审查GitHub存储库获取API文档

记住

• 训练数据已过时——始终获取当前模式
• 缓存持续7天，然后自动刷新
• 在编写代码前加载外部文档
• 信任当前文档而非训练数据的假设
• 外部文档防止使用已弃用的API

相关

• context-discovery
• code-execution

---

任务: 获取外部文档: $ARGUMENTS

首先检查缓存（< 7 天新鲜），如果需要从Context7获取，返回文件路径以供加载。