SuperAPI AI 工具集

cost-booster-route

部署与运维

查看项目

更新于 10-15 15:00

技能介绍

Cost Booster Route 是一个任务路由与成本分析工具,来源于 ruvnet/ruflo。它封装了 mcp__plugin_ruflo-core_ruflo__hooks_route,并报告三层路由器将多少任务分类为 Agent Booster(Tier 1)可用。Tier 1 绕过以 WASM 变换方式运行——不调用 LLM,结构上成本为 $0。

用途

该工具用于在批量执行相似任务之前,或当成本报告(cost-report)显示 Sonnet/Opus 花费在看似简单变换的描述上时使用。这些简单变换包括:var-to-const、add-types、add-error-handling、async-await、add-logging、remove-console。

主要能力

  1. 收集任务:支持单个参数,或通过 memory_search 从 cost-tracking 中获取最近条目。批次上限为 50。
  2. 路由每个任务:使用描述调用 hooks_route,并捕获完整响应字符串。
  3. 分区:根据响应中是否包含字面量 [AGENT_BOOSTER_AVAILABLE](Tier 1)与不包含(Tier 2/3)进行分组。当存在 [TASK_MODEL_RECOMMENDATION] Use model="X" 时,提取推荐模型。
  4. 计算花费:Tier 1 分区为 $0;Tier 2/3 分区按每个任务的上界计算,依据 REFERENCE.md 定价乘以推荐模型。
  5. 生成报告:输出类似以下格式的报告: === Booster bypass report === Tasks analyzed: 50 Tier 1 (booster): 18 (36%) — $0.00 Tier 2/3 (LLM): 32 (64%) — $X.XX (upper-bound) Booster intents: var-to-const (8), add-types (5), remove-console (5)
  6. 持久化:通过 memory_store --namespace cost-tracking --key "booster-route-$(date +%Y%m%d-%H%M%S)" --value '{"tier1": N, "tier2_or_3": M, ...}' 存储结果,以便 cost-report 获取层级信号。

使用方式

该工具通过封装 hooks_route 实现,使用流程为:收集任务、逐个路由、按 [AGENT_BOOSTER_AVAILABLE] 分区、计算花费、生成报告、持久化到 cost-tracking 命名空间。具体调用方式与集成细节暂未提供。

适用场景

适用于需要在批量任务执行前评估成本、识别可绕过 LLM 的简单变换任务、以及优化路由成本的场景。特别适合当成本报告显示在简单变换描述上产生 Sonnet/Opus 花费时使用。

限制与注意事项

  1. 上游声称,尚未验证:[AGENT_BOOSTER_AVAILABLE] 仅在上游路由器填充 routeResult.agentBoosterIntent.type 时触发(v3/@claude-flow/cli/src/mcp-tools/hooks-tools.ts:1228)。已发布 CLI 的语义-VectorDb 路径不总是触发分类器——应将分区视为 Tier 1 资格的下界。
  2. CLAUDE.md 根文档声称 <1ms 延迟和比 LLM 快 352×。<1ms 和 $0 是结构性的;352× 是上游声称,尚未在此验证。应报告路由器实际返回的内容。
  3. 完整的上游声称与实测对比表见 docs/benchmarks/0002-baseline.md。

交叉引用

ADR-0002 Decision #1 · ruflo-intelligence ADR-0001 §"Neutral"(通过 cost-optimize 步骤 8 闭合路由结果循环)· CLAUDE.md 根文档 §"3-Tier Model Routing (ADR-026)"。