新闻详情

新闻详情

首页 / 资讯中心 / 详情

Klavis Context7 文档检索 Skill 深度解析:让 AI 编码助手自动获取最新库文档

发布时间:2026/9/17 6:43:27来源:尧图网络
Klavis Context7 文档检索 Skill 深度解析:让 AI 编码助手自动获取最新库文档
Klavis Context7 文档检索 Skill 深度解析让 AI 编码助手自动获取最新库文档【免费下载链接】klavisKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale项目地址: https://gitcode.com/GitHub_Trending/kl/klavis在 AI 编码助手中训练数据过期导致 API 幻觉是最常见的问题之一。Klavis 仓库内的 Context7 插件位于mcp_servers/context7/plugins/claude/context7/为此设计了一个名为documentation-lookup的 Skill当用户询问库、框架或需要代码示例时该 Skill 自动触发引导 Agent 调用 Context7 MCP 工具的resolve-library-id与query-docs从实时文档源获取当前准确的资料而不是依赖模型记忆。读完本文你将掌握该 Skill 的触发条件、四步文档获取工作流、参数传递细节、版本固定version pinning策略以及它在 MCP 服务端源码中的真实工具注册实现。一、documentation-lookup Skill 是什么documentation-lookup是 Context7 Claude Code 插件中的一个 Skill 文件位于 SKILL.md。它是纯 Markdown 描述的提示词模板通过 YAML frontmatter 声明元信息--- name: documentation-lookup description: This skill should be used when the user asks about libraries, frameworks, API references, or needs code examples. Activates for setup questions, code generation involving libraries, or mentions of specific frameworks like React, Vue, Next.js, Prisma, Supabase, etc. ---nameSkill 的标识名即documentation-lookupdescription描述该 Skill 的激活场景客户端Claude Code 等依据这段描述判断何时自动启用该 Skill。Skill 的核心指令只有一句话当用户询问库、框架或需要代码示例时使用 Context7 获取当前文档而不是依赖训练数据use Context7 to fetch current documentation instead of relying on training data。Context7 插件在 README 中将其定位为四大组件之一MCP Server 提供工具、Skills 负责在用户询问库时自动触发文档检索、Agents 提供独立的docs-researcher子代理、Commands 提供手动查询入口/context7:docs。二、Skill 的触发条件SKILL.md 明确列出了四类激活场景用户出现以下任一情况时即应启用该 Skill触发场景典型问法安装/配置类问题How do I configure Next.js middleware?涉及库的代码生成Write a Prisma query for...API 参考类问题What are the Supabase auth methods?提及特定框架React、Vue、Svelte、Express、Tailwind 等这一设计让文档检索无感触发——用户不需要在提示词中显式写 use context7。这一点在 Claude Code 集成文档 中也有印证插件安装后Skill 会自动识别何时需要文档用户可直接问How do I set up authentication in Next.js 15?这类问题。三、四步文档获取工作流核心这是 SKILL.md 的核心内容规定了 Agent 从用户问题到最终回答必须走完的四步Step 1解析库 IDresolve-library-id调用resolve-library-id工具传入两个参数libraryName从用户问题中提取的库名query用户的完整问题原文文档明确指出这能提升相关性排序。Step 2选择最佳匹配从解析结果中依据三条标准挑选目标库与用户所问名称完全匹配或最接近更高的 benchmark score 代表更好的文档质量如果用户提及版本如 React 19优先选择版本专属 ID。Step 3获取文档query-docs调用query-docs工具传入libraryId选定的 Context7 库 ID格式如/vercel/next.jsquery用户的具体问题。Step 4使用文档将取回的文档融入回答使用当前、准确的信息回答用户问题附上文档中的相关代码示例在相关时注明库的版本。这套流程在插件的 docs-researcher 代理定义 中被原样复用并进一步细化增加识别库名返回聚焦回答等步骤说明四步工作流是整个插件的统一检索协议。四、源码级印证两个工具在 MCP 服务端如何注册上述两个工具并非 Skill 自行实现而是由 Context7 MCP Server 注册的真实 MCP 工具。在 MCP 服务端入口 中可以看到它们的完整注册逻辑与 SKILL.md 描述的参数一一对应resolve-library-id 的输入与返回server.registerTool( resolve-library-id, { title: Resolve Context7 Library ID, inputSchema: { query: z.string().describe( The users original question or task. This is used to rank library results by relevance ...), libraryName: z.string().describe( Library name to search for and retrieve a Context7-compatible library ID.), }, ...要点依据源码描述可直接用于指导实践前置约束工具描述明确要求除非用户直接提供了/org/project或/org/project/version格式的库 ID否则必须先调用resolve-library-id再调用query-docs调用上限工具描述中写入 Do not call this tool more than 3 times per question即每个问题最多调用 3 次超出后应使用已有最佳结果——这是对 Agent 行为的硬约束返回字段每条结果包含 Library ID/org/project格式、Name、Description、Code Snippets可用代码示例数、Source ReputationHigh/Medium/Low/Unknown、Benchmark Score100 为最高分、以及可用 Versions 列表版本提示当结果包含 Versions 且用户在问题中给出了版本时应使用/org/project/version形式的 ID该工具带readOnlyHint: true注解表明只读、无副作用。query-docs 的输入与约束inputSchema: { libraryId: z.string().describe( Exact Context7-compatible library ID (e.g., /mongodb/docs, /vercel/next.js, /supabase/supabase, /vercel/next.js/v14.3.0-canary.87) ...), query: z.string().describe( The question or task you need help with. Be specific and include relevant details. Good: How to set up authentication with JWT in Express.js ... Bad: auth or hooks ...), }源码中对query参数的描述与 SKILL.md Be specific 的准则相互印证好的 query 是How to set up authentication with JWT in Express.js坏的 query 是孤立的auth或hooks。两个工具的 description 中同时强调query 中不得包含 API 密钥、密码、凭据或个人数据等敏感信息。底层请求目标服务端所有检索请求最终指向 Context7 的 API 基址定义在 constants.tsconst CONTEXT7_BASE_URL https://context7.com; const MCP_RESOURCE_URL https://mcp.context7.com; export const CONTEXT7_API_BASE_URL process.env.CONTEXT7_API_URL || ${CONTEXT7_BASE_URL}/api;CONTEXT7_API_URL、RESOURCE_URL、AUTH_SERVER_URL均支持环境变量覆盖说明 Skill 所依赖的文档服务是远端服务本地 MCP Server 只是协议桥接层。五、行为准则让检索更准的三个 GuidelinesSKILL.md 的 Guidelines 部分给出三条可操作的检索准则其依据均可在源码中找到对应Be specific具体化把用户完整问题作为 query 传入。对应query-docs工具描述中Good/Bad示例的对比越具体召回越准Version awareness版本感知用户提到版本Next.js 15、React 19时优先使用解析步骤返回的版本专属库 ID。库 ID 的版本格式为/org/project/version例如/vercel/next.js/v15.1.8、/supabase/supabase/v2.45.0示例见 插件 README 的 Version Pinning 一节。resolve-library-id返回的 Versions 列表可帮助挑出与项目一致的版本Prefer official sources优先官方源多个匹配时优先官方/主包而非社区 fork。这与工具描述中的 Source ReputationHigh/Medium 更权威排序维度一致。六、Skill 的插件生态位与 Agent、Command 的分工documentation-lookupSkill 不是孤立存在的。Context7 插件README为查文档这一目标提供了三种互补入口理解它们能避免重复造轮子入口文件定位Skilldocumentation-lookup/SKILL.md自动触发用户问库/框架时静默执行四步流程Agentdocs-researcher.md独立上下文执行同一流程返回聚焦答案避免污染主对话上下文使用 Sonnet 轻量模型保速度Commanddocs.md手动查询/context7:docs library [query]若参数以/开头则直接作为库 ID 跳过解析步骤Command 定义中还给出了带版本固定的完整示例/context7:docs /vercel/next.js/v15.1.8 middleware /context7:docs /facebook/react/v19.0.0 use hook其工作机制来自 commands/docs.md库名以/开头时直接作为 Context7 ID 使用否则先经resolve-library-id匹配再经query-docs取回文档。七、安装与运行方式Skill 随 Context7 插件整体分发按 插件 README 在 Claude Code 中安装claude plugin marketplace add upstash/context7 claude plugin install context7-plugincontext7-marketplace安装后 Skill、Agent、Command 一并生效。若只关注 Skill 本身Context7 CLI 也提供了独立的 skills 安装机制见 docs/skills.mdxctx7 skills install project skill --claude # 安装到 .claude/skills/ ctx7 skills list --claude # 查看已安装Skill 依赖的 MCP Server 有两种接入方式见 docs/clients/claude-code.mdx# 远程托管 Server推荐无本地依赖 claude mcp add --header CONTEXT7_API_KEY: YOUR_API_KEY --transport http context7 https://mcp.context7.com/mcp # 本地 Server需 Node.js 18包版本见 server.jsonupstash/context7-mcp 2.0.2 claude mcp add context7 -- npx -y upstash/context7-mcp --api-key YOUR_API_KEY接入后可用/mcp或claude mcp list验证连接状态。从 server.json 可见CONTEXT7_API_KEY为可选isRequired: false的密钥型环境变量未配置时走匿名访问端点配置后走带鉴权的端点。八、小结documentation-lookupSkill 用一份简短的 Markdown 定义了 AI 编码助手查文档的标准作业程序四类触发条件 四步工具调用流程 三条行为准则。它的价值在于把何时查、查哪个库、怎么传参、版本怎么选这些决策固化成 Agent 可遵循的确定性流程且每个环节都能在 MCP 服务端源码 的工具注册描述中找到对应约束3 次调用上限、版本 ID 格式、官方源优先。在 Klavis 这类聚合大量 MCP Server 的仓库中这种Skill 驱动工具编排的模式是 AI Agent 可靠使用外部工具服务的典型范例。【免费下载链接】klavisKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale项目地址: https://gitcode.com/GitHub_Trending/kl/klavis创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考
网站建设高端定制企业官网
RELATED

相关资讯

更多精彩内容,欢迎继续阅读

较早相关资讯

最新相关资讯

ADRC自抗扰控制实战:嵌入式轻量化实现与工程落地 2026/9/17 7:25:33

ADRC自抗扰控制实战:嵌入式轻量化实现与工程落地

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
AI工具助力自考论文写作:九大工具实战评测与高效方案 2026/9/17 7:25:33

AI工具助力自考论文写作:九大工具实战评测与高效方案

1. 论文写作痛点与AI工具的价值写毕业论文是每个自考生都要经历的一道坎。作为过来人,我深知自考生的三大困境:时间碎片化、学术资源有限、缺乏系统指导。白天上班晚上带娃,周末还要抽空学习,这种状态下要完成一篇8000字以上的毕业…

阅读更多 →
gm/ID方法实战:从特征曲线到运放尺寸计算的完整流程 2026/9/17 7:25:33

gm/ID方法实战:从特征曲线到运放尺寸计算的完整流程

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →
Cursor与编程模型:AI编程工作流搭建及跨文件重构实战 2026/9/17 7:25:33

Cursor与编程模型:AI编程工作流搭建及跨文件重构实战

最近在开发者群里待着,话题绕来绕去总会撞到两个词:一个是Grok 4.5,一个是Cursor。标题里那句"Cursor 数据喂出来的编程模型",看着像一句调侃,其实戳中了一个很实在的技术判断——过去两年真正稀缺的&#x…

阅读更多 →
pentagi实战:五组件架构打造可观测的通用Agent智能体 2026/9/17 7:25:33

pentagi实战:五组件架构打造可观测的通用Agent智能体

最近一段时间,我频繁在开发者社区和几个技术群里看到pentagi被反复提及。一开始我以为又是什么套壳的 Agent 框架,直到我把它拉下来跑了一个星期,才意识到这个项目切入的角度确实有点东西:它没有把精力放在“多 Agent 聊天”或者“…

阅读更多 →
UFS逻辑单元管理详解:概念、配置与排障实战 2026/9/17 7:22:33

UFS逻辑单元管理详解:概念、配置与排障实战

/* MD / 富文本中的 .toc(含博客园搬家等嵌套结构);.toc-box 在侧栏,不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p(:empty 仍占 20px),一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

阅读更多 →

今日资讯

本周资讯

本月资讯

看完文章仍有疑问?

联系尧图顾问,获取一对一建站咨询

立即免费咨询 📞 400-888-8888
📞