Agent Skills
返回列表
Web 工具链决策指南

Web 工具链决策指南

AI Agent 更新于 2026.08.30

将以下提示词粘贴到你的 AI 对话框中：

请根据 https://skillhub.cn/install/skillhub.md，安装 @user_f6d596e2/humanizer-1234。

技能介绍

要解决什么问题

Agent 在联网取数时，常见失败来自选错工具：对 SPA 用 web_fetch 拿到骨架页，或对静态文档一上来就开 browser。静默降级还会让用户不知道为何变慢、为何需要登录。

本技能把 Web 侧能力收成一条可执行的决策链：先按场景选路，失败再按固定顺序升级，并在切换工具时说明原因。

核心能力与决策顺序

遵循 ReAct 范式；web_search、web_fetch、opencli、browser 不是层级嵌套，而是分支决策。

  • web_search：没有明确 URL、需要搜新闻/资料/对比信息时，直接传关键词；返回的 URL 再按流程用 web_fetch、opencli 或 browser 深入。
  • web_fetch：已知 URL 且页面偏静态（文章、文档、API、RSS）时使用；若空白页、403、CAPTCHA 或骨架 HTML，先试 opencli，再考虑 browser。
  • opencli：在 search/fetch 失败或不适用时作为 browser 之前的 fallback；覆盖 70+ 站点、秒级结构化数据；首次 command not found 需跑安装脚本（幂等）。详细用法见 {baseDir}/references/opencli-guide.md。
  • browser：最后手段——JS 渲染、登录态、点击/表单/翻页、截图，或其它工具全部失败时。

web_search 报错时不得静默降级：先 read web-search-config.md 并按 Step 1 原样引导配置；用户拒绝配置后再用 well-known-sites.json + web_fetch，仍不行再升 browser。

边界与注意点

  • 登录：任何登录前须告知用户并获确认；敏感不可逆操作需二次确认。
  • browser 操作：优先 CSS 选择器 + 文本匹配；等待目标元素而非固定 sleep；CAPTCHA 无法自动处理时说明需人工介入。
  • 状态：登录后的多步操作应复用同一浏览器上下文。
  • 常用站 URL（登录页、搜索引擎等）从 well-known-sites.json 按 key 查找，{query} 替换为实际搜索词。

使用场景

  • 用户只描述「查某话题最新报道」而没有 URL，需先用 `web_search` 搜关键词，再按返回链接在 `web_fetch` 与 `opencli` 间选型取正文。
  • 目标页是微博/知乎等 SPA，`web_fetch` 得到骨架 HTML，需用 `browser` 等待关键 DOM 出现后抽取动态加载的回答或列表。
  • `web_search` 因未配置搜索 API 报错，需按 `web-search-config.md` 逐步引导用户配 Key；用户拒绝后再用 `well-known-sites.json` 里的站址配合 `web_fetch` 降级。
  • 已有静态技术文档或 RSS 的明确 URL，优先 `web_fetch`；若遇 403/CAPTCHA 则先试 `opencli` 取结构化数据，仍失败再升级到 `browser`。

适合人员

  • 正在编写带联网能力的 Agent 技能，需要把 search/fetch/opencli/browser 分支与失败顺序写进系统提示的后端或平台工程师。
  • 维护 Cursor/Claude 类技能 Markdown，希望 Agent 切换工具、登录与敏感操作前必须说明原因并征求确认的提示词编辑者。
  • 日常让 Agent 从百度/微博等入口查资料，希望优先轻量工具、仅在 JS 或登录态场景才开浏览器的研究或情报整理岗位。
  • 集成 opencli 后需在 CLI 未安装、command not found 时走幂等安装脚本，并能在 opencli 失败时再降级 browser 的自动化集成维护者。