前言¶
在 Cursor、Claude Code 等环境里，Agent 经常要执行「搜一下」「打开网页」「抓内容」这类任务，背后通常对应 web_search、web_fetch、browser、opencli 等能力。工具一多，失败路径也容易乱：搜索 API 未配置时只报一句错误、不知道还有 opencli 可以兜底、需要登录的站点没有明确指引，用户体感就是「明明能查，Agent 却放弃了」。
web-tools-guide 是 SkillHub 上的一条社区 Skill，定位是在 Agent 真正调用上述联网类工具之前，先按固定流程读完错误处理、降级链路和站点登录说明。下面介绍它是什么、能做什么，以及如何在本地安装启用。
这是什么¶
web-tools-guide（坐标 @user_ec205dbb/web-tools-guide，当前版本 1.0.2）由社区发布者 user_ec205dbb 维护，在 SkillHub 中归类为 knowledge-management，标签标明 requires_api_key=false（安装 Skill 本身不强制你提供 API Key；其中仍会说明在 web_search 等能力失败时如何引导用户配置相关 API）。
一句话：它不是又一个「搜索插件」，而是给 Agent 用的操作规范——规定何时必须先读这份 Skill、失败时怎么处理、以及从 opencli 到 browser 的降级顺序，避免漏用已有工具。
官方页面：SkillHub - web-tools-guide
技能资源地址：https://api.skillhub.cn/user_ec205dbb/web-tools-guide
核心功能¶
以下能力均来自 SkillHub 页面与预抓取简介，未展开 SKILL 正文细节。
调用前的强制阅读¶
在调用 web_search、web_fetch、browser 或 opencli 之前，Agent 应先加载并遵循本 Skill。官方说明指出：不读这份 Skill，容易错误处理失败场景并遗漏可用工具。
错误处理流程¶
当 web_search 失败时，Skill 要求走既定流程，其中包括引导用户配置 API（具体配置项以 Skill 正文为准），而不是静默结束或随意换工具。
降级链路（fallback chain）¶
简介中写明一条结构化降级思路：在动用 browser 之前，优先把 opencli CLI 作为后备——官方表述为可覆盖 70+ 站点 的结构化 fallback。目的是在「浏览器自动化更重、更慢」之前，先用命令行侧能力尝试获取内容。
站点登录 URL¶
Skill 内含按站点区分的登录 URL 说明，便于 Agent 在需要登录的页面上给出可操作的指引，而不是笼统说「请登录」。
触发场景（关键词）¶
当用户或任务涉及下列意图时，适合触发本 Skill（摘自官方简介）：
- 中文：搜索、上网、查资料、打开网站、抓取网页、新闻、热点
- 英文：
web search、fetch、browser、opencli
安装与启用¶
SkillHub 推荐两种方式：把安装提示交给 AI，或用 skillhub CLI 安装到当前 Agent 实际使用的 skills 目录。
1、安装 SkillHub CLI（若尚未安装）¶
先检查是否已有 CLI：
command -v skillhub && skillhub --version
未安装时，可按 SkillHub 安装文档 执行完整安装（CLI + 默认 Skill）：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
仅需 CLI 时：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
2、安装 web-tools-guide¶
官方页面给出的 AI 安装提示为：根据 https://skillhub.cn/install/skillhub.md，安装 @user_ec205dbb/web-tools-guide。
CLI 方式示例（必须用 --dir 指向当前环境的 skills 目录，否则默认装到 ./skills/ 可能不会被 Agent 加载）：
skillhub install user_ec205dbb/web-tools-guide --dir <你的 skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档）：
| 环境 | skills 目录 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或项目下的 .agents/skills/ |
安装后若 Agent 未立即识别新 Skill，按你所用客户端说明重启或刷新 skills 配置。
典型用法¶
本 Skill 的「用法」本质是约束 Agent 行为，而不是单独暴露一条终端命令。
- 安装到当前 Agent 的 skills 目录（见上一节）。
- 当任务命中「搜索 / 打开网站 / 抓取 / 新闻热点」等触发词时，Agent 在第一次调用
web_search、web_fetch、browser或opencli之前，应先读取web-tools-guide并按其中流程执行。 web_search失败：按 Skill 要求向用户说明 API 配置方向，而不是直接放弃联网任务。- 需要页面内容但搜索不足：按 Skill 中的降级顺序，优先尝试 opencli 覆盖的站点能力，再考虑 browser。
- 遇到需登录站点：参照 Skill 中的站点登录 URL 指引用户或选择合适工具。
公开资料未提供 SKILL 正文内的逐步代码示例；复现方式以安装后 Agent 加载到的 SKILL.md 为准。
适用场景与注意¶
适合谁
- 经常让 Agent 查资料、读网页、跟热点，并希望失败时有统一话术和工具顺序的团队或个人。
- 已经在用 Cursor、Claude Code、Codex 等支持 Skills 的客户端，并愿意多装一条「联网前必读」规范。
限制与注意
- 来源为 community，行为细节以 Skill 正文为准；本文不展开未公开的配置字段。
requires_api_key=false仅表示 Skill 安装不强制 Key；实际web_search等能力仍可能依赖你所在环境里的 API 配置。- opencli「70+ 站点」为官方简介中的表述，能否覆盖你的目标站，需在环境中实测。
- SkillHub 页面统计（截至资料抓取）：评分 100000、下载 324555、安装 3459，说明使用面较广，但不代表与你本地工具链完全兼容，安装后建议用一次真实「搜索 + 抓取」任务验证。
结尾¶
web-tools-guide 的价值在于把联网类工具的失败处理、opencli 降级和登录指引写进 Agent 必读流程，减少「工具还在、任务却断了」的情况。若你的 Agent 经常上网查资料，可以先按 SkillHub 文档装到对应 skills 目录，再在真实任务里观察是否按 Skill 触发。
官方地址：https://api.skillhub.cn/user_ec205dbb/web-tools-guide
SkillHub 页面：https://www.skillhub.cn/skills/user_ec205dbb/web-tools-guide
