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