技能介绍

要解决什么问题

Agent 在联网取数时，常见问题是静默换工具：web_fetch 403 后直接开浏览器，或 web_search 报错就随便抓几个 URL。结果是耗时、难解释，还容易在登录、CAPTCHA 上踩坑。本技能把 Web 侧四个工具当成并列分支，而不是「从轻到重」的默认流水线，并要求每次切换都向用户说明原因。

技能如何工作

整体遵循 ReAct 范式，决策顺序可以概括为：

先选场景：没有明确 URL 时用 web_search；已知 URL 且页面偏静态（文档、博客、RSS）时用 web_fetch。
失败再分支：web_fetch 出现空白页、403、CAPTCHA、骨架 HTML 时，优先试 opencli（覆盖大量主流站点的结构化抓取），仍不行再升到 browser。
browser 作兜底：用于 SPA/动态加载、需要登录态、表单与翻页等交互，以及截图；只读流程强调等元素出现而不是固定 sleep。
web_search 报错：不静默降级，先按参考文档引导用户配置；用户明确拒绝后再走 well-known-sites + web_fetch，最后才 browser。

登录、发帖、支付等操作在技能里写死了边界：登录前必须征得用户确认，不可逆操作要二次确认；CAPTCHA 无法自动化时要说明需人工介入。

适用边界

适合：需要统一「何时用哪个 Web 工具、失败怎么降级、浏览器怎么等、登录怎么授权」的 Agent 技能作者或运维 Agent 的行为规范。
不适合：当作某个 CLI 的安装手册（opencli 仅说明首次 command not found 时跑安装脚本，细节在 references/）；也不替代各工具自身的 API 文档。
注意：opencli 与 browser 依赖本地环境；多步操作应复用同一浏览器上下文，避免重复开新会话丢登录态。