Search-Web 技能
概述
用最小搜索链路整合 Context7、Exa、网页正文读取、DeepWiki 和 github-fetcher。先确认必需 MCP 已可用，再拿官方文档、网页资料和仓库信息，避免首次使用时直接撞上工具缺失。
原则：每类搜索目标只有唯一 MCP，不允许降级替代。
何时使用
- 查询库、框架、SDK 或语言的官方文档（library docs, API reference, framework guides）
- 查找代码示例、教程、博客文章或最新网页资料（code examples, npm packages）
- 读取指定网页正文（仅在已知 URL 后）
- 查看 GitHub 仓库结构、文档、源码入口（README, source code, directory structure）
- 读取 GitHub 仓库中的具体文件或目录结构
- 遇到
library not found、rate limit、documentation outdated需要查最新资料时
何时不使用
- 纯本地代码检索或无需联网的普通问答
- 需要直接执行代码、运行测试或调试业务逻辑
- 已有完整本地文档且无需联网验证
- 需要修改、重构代码（refactoring）
MCP 快速参考
| 搜索目标 | MCP | 固定规则 |
|---|---|---|
| 技术文档 | Context7 | 先 resolve-library-id 再 query-docs，每问题≤3次 |
| 网络搜索 | Exa | 唯一指定，不可替代 |
| GitHub 仓库文档 | mcp-deepwiki | 仓库级文档概览和深读 |
| GitHub 文件/目录 | github-fetcher | 具体文件或目录结构 |
| 网页正文 | 宿主读取工具 | 仅已知 URL 后使用 |
核心流程
- 使用时的第一个步骤，运行
bash scripts/detect.sh，解析输出：
- initialized=true：直接进入步骤 2 - initialized=false：进入 references/setup.md 执行安装流程 进入 setup 前，先读取 credentials/ 目录下 context7 和 exa 文件：文件不存在或为空时询问用户是否配置 Key，用户选择跳过则写入 "skipped"，后续不再询问。 禁止在 MCP 缺失时用替代工具降级执行搜索任务。 任何 MCP 在步骤 2-6 执行中报告未注册、连接失败或 server unavailable 时，必须停止当前搜索，回到 references/setup.md 修复。
- 配置项类问题（阈值、开关、flag、option、parameter、env）先读
references/strategies/config-index-shortcut.md。 - 技术文档先走
Context7（先resolve-library-id再query-docs），模板和错误示例见examples/usage.md。 - 联网搜索固定使用
Exa，不可替代；不可用时回references/setup.md修复。Context7 之后继续走Exa补网页资料。 - Exa 命中 GitHub 仓库时走
DeepWiki获取文档；需读具体文件或目录时走github-fetcher。 - 只有用户已给出明确 URL 或 Exa 已定位后才允许网页正文读取。正文读取不是搜索步骤，不能替代
Exa。 - 最终按
references/rules/output-format.md组织回答，优先给官方文档，再给网页资料、正文读取结果和仓库信息。
MCP 使用边界
工具映射见上方"MCP 快速参考"表。固定禁止：
- 禁止用
open-websearch或其他搜索型 MCP 替代Exa - 禁止用
mcp-deepwiki替代github-fetcher的文件读取，或反之 - 禁止在 MCP 缺失时用替代工具降级执行搜索任务
常见错误
- 跳过
resolve-library-id直接猜测libraryId（Context7 必须两步调用） - 缺少
libraryName参数调用resolve-library-id - 用
libraryName传给query-docs（应该用libraryId） Exa不可用时切换到其他搜索 MCP（必须回 setup 修复）- 把网页正文读取当成搜索步骤替代
Exa - 用
mcp-deepwiki替代github-fetcher读文件，或反之 - Context7 超过 3 次调用限制后仍继续调用（应转 Exa）
- setup 状态未通过时跳过直接搜索
按需继续加载
只有在以下场景再读 examples/usage.md：
- 需要
Context7、Exa、网页正文读取、DeepWiki或github-fetcher的参数示例 - 需要
Context7的错误示范、调用顺序示例或多源整合案例 - 需要网页读取降级案例
- 需要常见失败场景或排障示例
如果示例文档与正文流程冲突，以本文件为准。
首次使用，或者 bash scripts/detect.sh 输出 initialized=false 时，读 references/setup.md。
需要标准输出模板、来源标注规则或 Markdown 结构约束时，读 references/rules/output-format.md。
遇到精确配置项名、阈值、开关、flag、option、parameter、env 一类问题时，读 references/strategies/config-index-shortcut.md。
输出要求
- 最终回答前，必须按
references/rules/output-format.md格式化 - 明确标注来源类型：
Context7、Exa、网页读取、DeepWiki、github-fetcher - 保留原始链接、文档入口或仓库标识
- 如果
Exa缺失、不可用或环境异常，不允许切换到其他搜索型 MCP，必须直接说明并回到 setup/repair - 如果发生降级、读取失败或信息不足，要直接说明
- 不编造未读取到的内容