Context7 文档查询是一个面向库与框架文档检索的技能。它的核心用途是:当用户询问某个库、框架、API 参考,或需要代码示例时,主动通过 Context7 拉取最新文档,避免仅依赖模型的训练数据。
适用触发场景
当用户提出以下类型的需求时,会激活该技能:
- 询问安装或配置问题,例如“如何配置 Next.js 中间件?”
- 请求涉及某个库的代码,例如“帮我写一个 Prisma 查询……”
- 需要 API 参考,例如“Supabase 的认证方法有哪些?”
- 提到具体框架,例如 React、Vue、Svelte、Express、Tailwind 等。
获取文档的步骤
第一步:解析库标识。调用 resolve-library-id,并传入:
- libraryName:从用户问题中提取的库名称
- query:用户的完整问题(有助于提升相关性排序)
第二步:选择最佳匹配。根据解析结果,按以下标准选择:
- 与用户所问名称完全一致或最接近的匹配
- 基准分数更高,通常代表文档质量更好
- 如果用户提到了版本(如“React 19”),优先选择带版本号的标识
第三步:获取文档。调用 query-docs,并传入:
- libraryId:选定的 Context7 库标识,例如 /vercel/next.js
- query:用户的具体问题
第四步:使用文档。把获取到的文档融入回答:
- 用当前、准确的信息回答用户问题
- 包含文档中的相关代码示例
- 在相关时注明库的版本
使用准则
- 要具体:把用户的完整问题作为 query 传入,以获得更好的结果。
- 注意版本:当用户提到版本(如“Next.js 15”“React 19”)时,如果解析步骤返回了版本特定的库标识,应优先使用。
- 优先官方来源:当存在多个匹配时,优先选择官方或主包,而不是社区分支。
限制与未提供信息
关于该技能的具体收费、价格、支持平台、实际效果等细节,资料中暂未提供。