前言¶
在 Cursor、Claude Code 等環境裏,模型自帶的聯網能力往往依賴當前會話是否開啓搜索、或是否接好了 MCP。用戶一句「查一下」「幫我找」若不能穩定映射到同一套流程,Agent 要麼拒絕、要麼憑訓練數據作答,時效性和可覈對性都打折。
下面介紹 SkillHub 上的「網頁搜索技能」:用通用 SKILL.md 約定觸發詞與行爲,讓 Agent 在用戶表達檢索意圖時執行網頁搜索並彙總結果,把「要不要搜、怎麼搜」寫進技能定義,而不是每次靠臨場判斷。
這是什麼¶
「網頁搜索技能」是社區發佈者 user_c5d687fe 在 SkillHub 上架的 Agent Skill,座標爲 @user_c5d687fe/web-search-skill-v2,當前版本 1.0.0,分類爲 knowledge-management,來源標記爲 community。
官方簡介概括爲:執行網頁搜索並彙總結果;當用戶出現「搜索」「查一下」「找一下」「幫我查」「搜索一下」等意圖時觸發此技能。頁面標籤標明 requires_api_key=false,即按 SkillHub 元數據無需單獨配置 API Key 即可安裝使用(具體搜索後端以實現爲準,以技能包內 SKILL.md 爲準)。
SkillHub 頁面:https://www.skillhub.cn/skills/user_c5d687fe/web-search-skill-v2
API 座標頁:https://api.skillhub.cn/user_c5d687fe/web-search-skill-v2
核心功能¶
依據官方簡介與 SkillHub 展示信息,可覈實的能力如下:
- 意圖觸發:識別用戶自然語言中的檢索意圖(如「搜索」「查一下」「找一下」「幫我查」「搜索一下」等表述),在滿足條件時啓用本技能,而不是僅依賴模型是否「記得」去聯網。
- 網頁搜索:針對用戶問題發起網頁搜索(具體檢索通道與參數由技能包內說明定義)。
- 結果彙總:將檢索到的網頁信息整理後回覆用戶,便於在對話中直接引用與覈對。
技能本體遵循通用 SKILL.md 格式,便於在支持 Skills 的客戶端中安裝與版本管理。
安裝與啓用¶
安裝流程以 SkillHub 官方安裝文檔爲準:https://skillhub.cn/install/skillhub.md。Skill 詳情頁給出的安裝提示爲:按上述文檔安裝座標 @user_c5d687fe/web-search-skill-v2。
1、檢查 SkillHub CLI¶
先確認本機是否已有 skillhub:
command -v skillhub && skillhub --version
若未安裝,可使用官方一鍵腳本(完整安裝含 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、安裝到當前 Agent 的 skills 目錄¶
官方強調:安裝時必須用 --dir 指向當前 Agent 實際讀取的 skills 目錄,否則默認會裝到 ./skills/,客戶端可能無法加載。
skillhub install @user_c5d687fe/web-search-skill-v2 --dir <skills 目錄>
常用客戶端的 skills 路徑(摘自 SkillHub 安裝文檔):
| 客戶端 | skills 目錄 |
|---|---|
| Cursor | ~/.cursor/skills/ |
| Claude Code | ~/.claude/skills/ |
| Codex | ~/.codex/skills/ 或項目下的 .agents/skills/ |
示例(Cursor):
skillhub install @user_c5d687fe/web-search-skill-v2 --dir ~/.cursor/skills/
安裝完成後,按你所用客戶端的要求重啓或刷新 Agent,使新技能被加載。Codex CLI、Claude Code 與 Cursor 的差異主要體現在 skills 目錄路徑;安裝命令形式一致,均爲 skillhub install 加 --dir。
也可將下面提示交給支持 Skills 的 AI,由其按 install 文檔完成安裝:
請根據 https://skillhub.cn/install/skillhub.md,安裝 @user_c5d687fe/web-search-skill-v2。
典型用法¶
本技能的設計重點是用自然語言觸發,而非固定 CLI 子命令。安裝並啓用後,在對話中直接使用官方簡介列出的意圖表述即可,例如:
- 「搜索一下 Rust 2024 版本發佈說明」
- 「幫我查 Cursor Skills 的安裝目錄」
- 「找一下 SkillHub 上 knowledge-management 分類還有哪些技能」
Agent 識別到檢索意圖後,應走技能定義的搜索與彙總流程,並在回覆中體現來自網頁檢索的信息(而非僅依賴模型內部知識)。具體檢索範圍、條數、是否附帶鏈接等細節,以安裝後的 SKILL.md 與技能包內腳本爲準。
適用場景與注意¶
適合誰
- 經常在 Agent 對話裏做資料查證、文檔覈對、新聞或版本信息查詢的開發者。
- 希望把「何時搜索、如何彙總」固化成技能,減少每次手動開聯網或配 MCP 的操作。
- 使用 Cursor、Claude Code、Codex 等已支持 SkillHub 安裝路徑的環境。
需要注意
- 網頁搜索結果受檢索源與索引時效影響,重要決策仍應點開原始頁面覈對。
- 安裝路徑錯誤是常見坑:務必
--dir到當前客戶端的 skills 目錄。 - SkillHub 元數據中的評分、下載量會隨時間變化;撰寫時頁面顯示評分爲 100000、下載 3729(以 SkillHub 實時頁面爲準)。
- 本技能標註
requires_api_key=false;若後續版本或子依賴要求密鑰,以技能包更新說明爲準。
結尾¶
「網頁搜索技能」把檢索意圖與「搜索 + 彙總」行爲寫進 SKILL,適合作爲知識管理類技能棧裏的一塊基礎能力。需要安裝或查看詳情時,可打開 SkillHub 頁面:
https://www.skillhub.cn/skills/user_c5d687fe/web-search-skill-v2