mcpField
F
fetch-library-docs

fetch-library-docs

github.com/panaversity开发49 次安装
代码仓库

关于 fetch-library-docs

一项为开发者获取官方库文档的技能，适用于实现、调试、安装、集成或升级库。它根据任务上下文判断库、主题和内容类型，并指导使用文档获取脚本。

主要功能

  1. 01自动识别任务上下文
  2. 02识别库和查询主题
  3. 03按任务选择内容类型
  4. 04提供文档获取脚本用法
  5. 05查阅常用库 ID

适用场景

  1. 01实现功能时查找 API 示例
  2. 02遇到错误时查询排障信息
  3. 03查看安装或迁移说明

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/panaversity/agentfactory --skill fetch-library-docs

安装后在 Claude Code 中输入/fetch-library-docs确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
context7-tools.md
library-ids.md
patterns.md
scripts/
detect-python.sh
extract-apidoc.sh
extract-code-blocks.sh
extract-migration.sh
extract-notes.sh
extract-patterns.sh
extract-prose.sh
extract-signatures.sh
extract-terminal-blocks.sh
extract-troubleshooting.sh
fetch-docs.sh
fetch-raw.sh
filter-by-type.sh
load-api-key.sh
mcp-client.py
setup-api-key.sh
start-server.sh
stop-server.sh

详细介绍

库文档技能

获取官方库文档，节省 60-90% 的 token。

何时调用（自动检测）

在以下情况自动调用：

场景检测信号内容类型
实现即将使用库 API 编写代码examples,api-ref
调试错误中包含库名称（例如 PrismaClientError）troubleshooting
安装添加新软件包、执行 npm install、设置任务setup
集成连接库（“将 X 与 Y 搭配使用”）examples,setup
升级版本迁移、重大变更migration
不确定首次使用库功能，不确定用法examples

以下情况不要调用：

  • 已从训练中掌握足够知识
  • 用户已粘贴文档或打开了文档
  • 任务涉及本地／私有代码（使用代码库搜索）
  • 比较库（使用网页搜索）

决策逻辑

1. 确定库
Priority: User mention → Error message → File imports → package.json → Ask user

示例：

  • PrismaClientKnownRequestError → 库 = "prisma"
  • import { useState } from 'react' → 库 = "react"
  • from fastapi import FastAPI → 库 = "fastapi"
2. 确定主题
Priority: User specifies → Error message → Feature being implemented → "getting started"
3. 选择内容类型
任务内容类型
实现代码examples,api-ref
调试错误troubleshooting,examples
安装／设置setup
集成库examples,setup
升级版本migration
理解原因concepts
最佳实践patterns

执行

# With known library ID (faster - saves 1 API call)
bash scripts/fetch-docs.sh --library-id <id> --topic "<topic>" --content-type <types>

# With library name (auto-resolves)
bash scripts/fetch-docs.sh --library <name> --topic "<topic>" --content-type <types>
常用库 ID
库ID
React/reactjs/react.dev
Next.js/vercel/next.js
Prisma/prisma/docs
Tailwind/tailwindlabs/tailwindcss.com
FastAPI/tiangolo/fastapi

完整列表请参阅 references/library-ids.md。

错误处理（速查）

错误操作
[LIBRARY_NOT_FOUND]尝试不同的拼写形式
[LIBRARY_MISMATCH]直接使用 --library-id
[EMPTY_RESULTS]扩大主题范围，或使用 --content-type all
[RATE_LIMIT_ERROR]检查 API 密钥设置

调用预算：Context7 每个问题允许调用 3 次。使用 --library-id 可节省 1 次调用。

完整的错误处理说明请参阅 references/context7-tools.md。

参考资料

评论

支持 Markdown