browser-toolkit — 浏览器自动化工具智能路由

定位：浏览器自动化的「决策中枢/调度层」。根据任务意图自动路由到最合适的执行工具。 与 agent-browser skill 边界：本 skill 负责「选哪个工具」，agent-browser skill 负责「怎么用 agent-browser」。

⚡ 快速决策矩阵（60 秒速查）

矩阵未覆盖？→ 加载 modules/decision-engine.md 做三维决策。

🧭 模块懒加载路由

按意图识别加载对应模块（只加载一个，避免 token 浪费）：

加载方式

# 示例：用户说"帮我分析下这个页面为什么慢"
read_file("modules/devtools-mcp-adapter.md")

# 示例：用户说"不确定用什么工具"
read_file("modules/decision-engine.md")

🎯 三维决策摘要

当矩阵无法命中时，按三维特征打分：

维度 1：任务目标（What）
  ├─ 自动化执行     → agent-browser
  ├─ 测试验证      → Playwright
  └─ 调试分析      → Chrome DevTools MCP

维度 2：浏览器状态（Where）
  ├─ 全新隔离实例   → agent-browser / Playwright
  ├─ 用户当前 Chrome → Chrome DevTools MCP
  └─ 跨浏览器内核   → Playwright

维度 3：执行主体（Who）
  ├─ AI 实时决策    → agent-browser / Playwright MCP
  ├─ 人维护脚本库   → Playwright（脚本）
  └─ AI 辅助人调试  → Chrome DevTools MCP

详细打分表、场景样例 → modules/decision-engine.md

🛡️ 智能降级策略（可用性兜底）

按优先级检测环境可用性：

1. agent-browser CLI 可用？ ─── agent-browser --version
   ├─ 是 → 首选
   └─ 否 → 继续 ↓
2. @playwright/cli 可用？ ─── playwright-cli --help
   ├─ 是 → 选它（Playwright 官方 2026 新推，AI 友好 + 跨浏览器）
   └─ 否 → 继续 ↓
3. Chrome 9222 调试端口开放 或 DevTools MCP 已配置？
   ├─ 是 → Chrome DevTools MCP（性能/调试类任务最优）
   └─ 否 → 继续 ↓
4. 直接用 Playwright MCP 或脚本（npx 开箱可用）

🚦 边界声明（重要）

为避免与现有 skill 冲突，本 skill 只处理以下场景：

• ✅ 多工具决策咨询："这个任务用什么工具"
• ✅ Chrome DevTools MCP 独占场景：性能分析、网络抓包、内存快照、复用真实 Chrome
• ✅ 跨工具协同编排：先调试 → 再复现 → 再固化测试的混合工作流

不处理（交给专门 skill）：

• ❌ 纯 agent-browser 命令 how-to → agent-browser skill
• ❌ 纯 Playwright 测试代码编写 → e2e-testing skill
• ❌ 简单"打开网站"/"截图"/"填表" → 直接走 agent-browser skill

🤔 不确定时的澄清询问

如果用户需求模糊（如"帮我看看这个页面"），先询问：

为了给你选最合适的工具，我想确认一下：

1. 🔍 **调试分析**（排查为什么慢/出错/内存泄漏）
2. 🤖 **自动化执行**（批量操作/爬数据/模拟用户）
3. 🧪 **测试验证**（写可回放的测试用例）
4. 🔀 **混合场景**（先调试再复现再固化为测试）

请选 1/2/3/4，或直接描述你想达成的结果。

📚 参考资料

模块（按需加载）

参考文档（references/）

模板（templates/）

🎁 与生态集成

• 独立调用（已实现）：用户任何工具选型咨询 → 本 skill
• 委托执行（已实现）：决策后 use_skill("agent-browser") 或 use_skill("e2e-testing")
• 被 dev-flow 调用（✅ 已接入）：dev-flow 步骤 1 研究（bug 复现现场采集，信号触发）/ 步骤 5 执行（UI 操作/调试场景智能路由）/ 步骤 6 验证（V4 Browser 进阶场景工具选型前置）均可通过 use_skill("browser-toolkit") 按需调用