前言¶
在 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
