前言¶
Agent 接到「搜一下」「打开这个站」「抓网页」这类任务时，往往会直接调用 web_search、web_fetch、browser 或 opencli。一旦搜索 API 未配置、接口报错，或站点需要登录，常见做法是反复重试同一工具，或过早拉起浏览器，既浪费步骤，也容易漏掉仍可用的结构化抓取路径。
下面介绍的 sfe（SkillHub 坐标 @user_9ca58e78/ddd）是一份面向 AI Agent 的规程型 Skill：要求在调用上述联网类工具之前先阅读其说明，并按其中约定的错误处理与降级顺序执行。它来自 SkillHub 社区（发布者 user_9ca58e78），分类为 ai-agent，当前版本 1.0.0，标签含 requires_api_key=true。
这是什么¶
sfe 不是某个网站的爬虫脚本，而是一套写进 SKILL.md 的操作约束与流程说明。官方简介将其定位为：在调用 web_search、web_fetch、browser、opencli 之前必须遵循的规程；未阅读该 Skill，容易错误处理失败场景并遗漏可用工具。
SkillHub 页面：https://www.skillhub.cn/skills/user_9ca58e78/ddd
API 条目（资料侧）：https://api.skillhub.cn/user_9ca58e78/ddd
核心功能¶
以下能力均来自 SkillHub 公布的简介，安装后应以 Skill 包内 SKILL.md 全文为准。
调用前强制阅读¶
在 Agent 准备使用 web_search、web_fetch、browser、opencli 任一能力前，应先加载并遵循 sfe 中的步骤，而不是凭默认习惯直接调工具。
搜索失败时的错误处理¶
当 web_search 失败时，规程要求引导用户完成 API 相关配置，而不是静默失败或无限重试。这与 Skill 标签 requires_api_key=true 一致：联网搜索往往依赖外部 API，未配置时应把问题明确交回给用户。
降级链（fallback chain）¶
简介约定了一条结构化降级路径：在动用浏览器之前，优先通过 opencli CLI 覆盖的 70+ 站点做结构化回退抓取。含义是：主路径（如搜索或通用 fetch）不可用时，先走 opencli 能处理的站点集合，再考虑 browser，以减少重、慢的浏览器自动化。
站点登录入口¶
Skill 内包含按站点整理的登录 URL，便于在需要登录的页面场景下，由 Agent 或用户按正确入口处理鉴权，而不是盲目打开首页。
触发意图（Trigger）¶
当用户或任务中出现下列意图时，应关联加载 sfe，例如：搜索、上网、查资料、打开网站、抓取网页、新闻、热点，以及英文表述 web search / fetch / browser / opencli 等。
安装与启用¶
SkillHub 官方安装说明见 https://skillhub.cn/install/skillhub.md。核心要点：安装技能时必须用 --dir 指向当前 Agent 实际使用的 skills 目录，否则默认装到 ./skills/ 可能不会被识别。
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、安装 sfe 到 Agent 的 skills 目录¶
将坐标 @user_9ca58e78/ddd 安装到当前环境对应的目录。SkillHub 文档给出的常见路径示例：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
安装命令形式如下（请将 <skills 目录> 换成你正在使用的 Agent 路径）：
skillhub install @user_9ca58e78/ddd --dir <skills 目录>
也可按 SkillHub 技能页提示，让 AI 根据 skillhub.md 完成安装，目标坐标同样为 @user_9ca58e78/ddd。
3、启用与 API¶
安装后需在 Agent 中启用该 Skill（具体入口因客户端而异，以你所用产品的 Skills 配置为准）。因标签为 requires_api_key=true，使用 web_search 等能力前，应按 sfe 与产品文档完成搜索类 API 的配置；失败时按 Skill 要求引导用户补全配置。
典型用法¶
官方页面未单独给出业务代码示例；可复现的流程来自简介与 Skill 类型本身，建议按下面顺序在 Agent 会话中落地。
- 用户提出联网类需求（如「查某新闻热点」「打开某站并抓取正文」）。
- Agent 先读取 sfe（
SKILL.md），再选择工具，而不是直接web_search/browser。 - 优先尝试简介中对应的主路径（如
web_search或web_fetch）；若web_search失败，按规程提示用户配置 API，不要假装已成功。 - 主路径仍不足时，按降级链尝试 opencli（覆盖 70+ 站点的结构化能力），再视情况使用 browser。
- 目标站需要登录时，查阅 Skill 内的站点登录 URL，按规程处理登录入口。
用户侧可显式触发，例如：「按 sfe 规程帮我搜索某某主题并抓官方页面」，以便 Agent 在调工具前加载该 Skill。
适用场景与注意¶
适合谁
- 经常让 Cursor、Claude Code、Codex 等 Agent 做搜索、抓页、跟热点的一线开发者。
- 希望统一「搜索失败怎么交代用户」「何时用 opencli、何时才开浏览器」的团队，用一份 Skill 约束 Agent 行为。
限制与注意
- 规程细节以安装包内
SKILL.md为准；本文仅概括 SkillHub 公开简介，未展开站内每条登录 URL 或 opencli 子命令。 - SkillHub 统计（社区来源）：评分 100000，下载 1539，安装 0（以抓取资料为准，页面展示可能更新）。
- 依赖
web_search时需自行准备并配置 API；sfe 强调失败时必须引导配置，而不是跳过。 - 安装目录错误会导致 Agent 读不到 Skill，务必使用
skillhub install ... --dir <skills 目录>。
结尾¶
sfe 的价值在于把「联网工具怎么调、失败了怎么办、还能降级到什么」写进 Agent 必读规程，减少误用 web_search、过早浏览器化、以及忽略 opencli 结构化回退等问题。需要安装或更新时，以 SkillHub 技能页与安装文档为准：https://www.skillhub.cn/skills/user_9ca58e78/ddd。
