---

name: documentation-lookup description: 通过 Context7 MCP 使用最新的库和框架文档，而非训练数据。当用户提出设置问题、API 参考、代码示例或提到框架（如 React、Next.js、Prisma）时激活。 origin: ECC

文档查询（Context7）

当用户询问库、框架或 API 时，通过 Context7 MCP（工具 resolve-library-id 和 query-docs）获取当前文档，而非依赖训练数据。

核心概念

• Context7：暴露实时文档的 MCP 服务器；用它代替训练数据查询库和 API。
• resolve-library-id：从库名和查询返回 Context7 兼容的库 ID（如 /vercel/next.js）。
• query-docs：为给定的库 ID 和问题获取文档和代码片段。始终先调用 resolve-library-id 获取有效的库 ID。

何时使用

在用户执行以下操作时激活：

• 提出设置或配置问题（如"如何配置 Next.js 中间件？"）
• 请求依赖库的代码（"写一个 Prisma 查询..."）
• 需要 API 或参考信息（"Supabase 的认证方法有哪些？"）
• 提到特定框架或库（React、Vue、Svelte、Express、Tailwind、Prisma、Supabase 等）

当请求依赖于库、框架或 API 的准确、最新行为时使用此技能。适用于配置了 Context7 MCP 的所有环境（如 Claude Code、Cursor、Codex）。

工作原理

步骤 1：解析库 ID

调用 resolve-library-id MCP 工具，参数为：

• libraryName：从用户问题中提取的库或产品名称（如 Next.js、Prisma、Supabase）
• query：用户的完整问题。这能改善结果的相关性排名。

必须在查询文档前获取 Context7 兼容的库 ID（格式 /org/project 或 /org/project/version）。没有此步骤的有效库 ID，不要调用 query-docs。

步骤 2：选择最佳匹配

从解析结果中，使用以下标准选择一个结果：

• 名称匹配：优先选择与用户请求完全匹配或最接近的
• 基准分数：更高的分数表示更好的文档质量（100 为最高）
• 来源信誉：可用时优先选择高或中信誉
• 版本：如果用户指定了版本（如"React 19"、"Next.js 15"），优先选择版本特定的库 ID（如 /org/project/v1.2.0）

步骤 3：获取文档

调用 query-docs MCP 工具，参数为：

• libraryId：步骤 2 中选择的 Context7 库 ID（如 /vercel/next.js）
• query：用户的具体问题或任务。越具体越能获得相关片段。

限制：每个问题不要调用 query-docs（或 resolve-library-id）超过 3 次。如果 3 次调用后答案仍不清楚，说明不确定性并使用已有的最佳信息，而非猜测。

步骤 4：使用文档

• 使用获取的当前信息回答用户问题
• 在有帮助时包含文档中的相关代码示例
• 在重要时引用库或版本（如"在 Next.js 15 中..."）

示例

示例：Next.js 中间件

1. 调用 resolve-library-id，libraryName: "Next.js"，query: "如何设置 Next.js 中间件？"
2. 从结果中按名称和基准分数选择最佳匹配（如 /vercel/next.js）
3. 调用 query-docs，libraryId: "/vercel/next.js"，query: "如何设置 Next.js 中间件？"
4. 使用返回的片段和文本回答；如相关则包含文档中的最小 middleware.ts 示例

示例：Prisma 查询

1. 调用 resolve-library-id，libraryName: "Prisma"，query: "如何查询关联？"
2. 选择官方 Prisma 库 ID（如 /prisma/prisma）
3. 使用该 libraryId 和查询调用 query-docs
4. 返回 Prisma Client 模式（如 include 或 select）并附带文档中的简短代码片段

示例：Supabase 认证方法

1. 调用 resolve-library-id，libraryName: "Supabase"，query: "认证方法有哪些？"
2. 选择 Supabase 文档库 ID
3. 调用 query-docs；总结认证方法并展示获取文档中的最小示例

最佳实践

• 具体化：尽可能使用用户的完整问题作为查询以获得更好的相关性
• 版本意识：当用户提到版本时，使用解析步骤中可用的版本特定库 ID
• 优先官方来源：当存在多个匹配时，优先选择官方或主要包而非社区分支
• 无敏感数据：从发送到 Context7 的任何查询中删除 API 密钥、密码、令牌和其他机密。在传递给 resolve-library-id 或 query-docs 之前，将用户的问题视为可能包含机密