网页搜索技能:为 Agent 补上可触发的网页检索与汇总

前言

在 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 展示信息,可核实的能力如下:

  1. 意图触发:识别用户自然语言中的检索意图(如「搜索」「查一下」「找一下」「帮我查」「搜索一下」等表述),在满足条件时启用本技能,而不是仅依赖模型是否「记得」去联网。
  2. 网页搜索:针对用户问题发起网页搜索(具体检索通道与参数由技能包内说明定义)。
  3. 结果汇总:将检索到的网页信息整理后回复用户,便于在对话中直接引用与核对。

技能本体遵循通用 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

羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

Xiaoye