Openakita tool-routing

Decision guide for choosing the right tool when operating websites, browsers, and desktop software. Consult when the task involves web interaction, website automation, or desktop app control.

install
source · Clone the upstream repo
git clone https://github.com/openakita/openakita
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openakita/openakita "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/system/tool-routing" ~/.claude/skills/openakita-openakita-tool-routing && rm -rf "$T"
manifest: skills/system/tool-routing/SKILL.md
source content

工具选择路由指南

当任务涉及操作网站、浏览器或桌面软件时,使用此指南选择最可靠的工具路径。

网站 & 浏览器操作

需要操作网站?
│
├─ 只需读取内容(文章、文档、API)
│   └─ web_fetch(最快,无需浏览器)
│
├─ 只需搜索信息
│   └─ web_search(DuckDuckGo 直接搜索)
│
├─ 需要交互(点击、填表、登录)
│   │
│   ├─ 目标网站有 opencli adapter?
│   │   └─ YES → opencli_run(最可靠,复用 Chrome 登录态)
│   │
│   ├─ 需要复杂多步交互?
│   │   └─ browser_task(自动规划步骤)
│   │       └─ 失败?→ 手动组合 browser_navigate + browser_click + browser_type
│   │
│   └─ 需要单步精确操作?
│       └─ browser_navigate / browser_click / browser_type 等
│
└─ 需要截图验证?
    └─ browser_screenshot → view_image

桌面软件操作

需要控制桌面软件?
│
├─ 有 cli-anything CLI?(cli_anything_discover 检查)
│   └─ YES → cli_anything_run(最可靠,调用真实后端)
│
├─ Windows 系统?
│   └─ desktop_* 工具(UIA/pyautogui GUI 自动化)
│
└─ 有命令行工具?
    └─ run_shell(直接执行)

可靠性排序

网站操作(从高到低)

  1. opencli_run — 确定性命令 + JSON 输出 + 登录态
  2. web_fetch — 简单 HTTP 获取(仅读取)
  3. browser_navigate + browser_click/type — 手动精确控制
  4. browser_task — AI 自主操作(可能不稳定)
  5. call_mcp_tool("chrome-devtools") — 需要额外配置

桌面软件操作(从高到低)

  1. cli_anything_run — CLI 调用真实后端
  2. run_shell — 系统命令行工具
  3. desktop_ 工具* — GUI 自动化(仅 Windows,脆弱)

关键原则

  • browser_task 失败不要反复重试 — 失败 1 次就切换到手动 browser_click/type 组合
  • 搜索类任务不要用 browser_task — 直接用 browser_navigate 拼 URL 参数更可靠
  • 有 opencli adapter 时总是优先使用 — 比让 LLM 猜测页面操作可靠得多
  • 有 cli-anything CLI 时优先使用 — 比 GUI 自动化可靠 100 倍