Back to Details

external-research

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

External Scout

External Scout

Overview

概述

Fetch and cache current documentation for external libraries and frameworks. Training data is outdated—this skill ensures you use current, correct API patterns.
Announce at start: "I'm using the external-scout skill to fetch current docs for [package]."
获取并缓存外部库和框架的最新文档。训练数据可能过时——此技能确保你使用最新、正确的API模式。
开始时需告知： "我将使用external-scout技能获取[包名]的最新文档。"

The Process

流程

Step 1: Invoke External-Scout

步骤1：调用External-Scout

Request documentation with package and topic:
bash
/external-scout <package> <topic>
Examples:
bash
/external-scout drizzle schemas
/external-scout react hooks
/external-scout express middleware
/external-scout zod validation
请求指定包和主题的文档：
bash
/external-scout <package> <topic>
示例：
bash
/external-scout drizzle schemas
/external-scout react hooks
/external-scout express middleware
/external-scout zod validation

Step 2: Check Response

步骤2：检查响应

External-scout returns JSON with cached file paths:
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"
  }
}
Cache status:
  • "fresh"
    — < 7 days old (use cached)
  • "stale"
    — > 7 days old (re-fetches automatically)
External-scout会返回包含缓存文件路径的JSON：
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天（将自动重新获取）

Step 3: Load Cached Documentation

步骤3：加载缓存文档

Read the returned file:
bash
Read: .tmp/external-context/drizzle/schemas.md
This file contains current API patterns, examples, and best practices.
读取返回的文件：
bash
Read: .tmp/external-context/drizzle/schemas.md
该文件包含最新的API模式、示例和最佳实践。

Step 4: Apply to Implementation

步骤4：应用到实现中

Use loaded documentation to:
  • Verify API signatures are correct
  • Follow current patterns (not training data)
  • Check for deprecations
  • Use new features introduced since training
使用加载的文档来：
  • 验证API签名是否正确
  • 遵循最新模式（而非训练数据）
  • 检查是否有废弃内容
  • 使用训练数据之后推出的新功能

Step 5: Implement with Confidence

步骤5：放心实现

Now that you have current docs, implement following verified patterns.
现在你已获取最新文档，可以按照验证后的模式进行实现。

Example: Using Drizzle ORM

示例：使用Drizzle ORM

markdown
1. Invoke: /external-scout drizzle schemas

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

3. Load: Read .tmp/external-context/drizzle/schemas.md

4. Review: Current API for defining tables and relations

5. Implement: Use current patterns from loaded docs
markdown
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. 实现：使用加载文档中的最新模式

Cache Location

缓存位置

.tmp/external-context/
├── drizzle/
│   ├── .metadata.json
│   ├── schemas.md
│   └── queries.md
├── react/
│   ├── .metadata.json
│   └── hooks.md
└── express/
    ├── .metadata.json
    └── middleware.md
Cache files auto-refresh after 7 days.
.tmp/external-context/
├── drizzle/
│   ├── .metadata.json
│   ├── schemas.md
│   └── queries.md
├── react/
│   ├── .metadata.json
│   └── hooks.md
└── express/
    ├── .metadata.json
    └── middleware.md
缓存文件会在7天后自动刷新。

Error Handling

错误处理

"External documentation fetch failed":
  • Check internet connection
  • Try again in a few minutes
  • Fallback: Visit official docs manually
"Cache is stale, re-fetching":
  • Normal behavior—external-scout auto-fetches fresh docs
"Package not found in Context7":
  • Visit official package documentation
  • Check npm/PyPI for package README
  • Review GitHub repository for API docs
"外部文档获取失败"：
  • 检查网络连接
  • 几分钟后重试
  • 备选方案：手动访问官方文档
"缓存已过期，正在重新获取"：
  • 正常行为——external-scout会自动获取最新文档
"在Context7中未找到该包"：
  • 访问该包的官方文档
  • 查看npm/PyPI上的包README
  • 查看GitHub仓库中的API文档

Remember

注意事项

  • Training data is OUTDATED—always fetch current patterns
  • Cache lasts 7 days before auto-refresh
  • Load external docs BEFORE writing code
  • Trust current docs over training data assumptions
  • External docs prevent using deprecated APIs
  • 训练数据已过时——务必获取最新模式
  • 缓存7天后自动刷新
  • 编写代码前先加载外部文档
  • 优先信任最新文档，而非训练数据的假设
  • 外部文档可避免使用已废弃的API

Related

相关技能

  • context-discovery
  • code-execution
Task: Fetch external documentation for: $ARGUMENTS
Check cache first (< 7 days fresh), fetch from Context7 if needed, return file paths for loading.
  • context-discovery
  • code-execution
任务：获取以下内容的外部文档：$ARGUMENTS
先检查缓存（小于7天为最新），必要时从Context7获取，返回用于加载的文件路径。