mcpField
R
router-first-architecture

router-first-architecture

github.com/parcadeiAgent 工作流3.9k468 次安装39 周前更新
代码仓库

关于 router-first-architecture

一种先经领域路由器再调用具体工具的 Agent 架构实践,适用于希望将意图映射与工具选择集中管理的工作流。

主要功能

  1. 01优先通过领域路由器
  2. 02依据置信度决定是否回退
  3. 03领域技能与路由器共同激活
  4. 04分离触发层与路由层

适用场景

  1. 01将数学意图映射到 CLI 命令
  2. 02避免技能直接调用已有路由器覆盖的脚本

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/parcadei/continuous-claude-v3 --skill router-first-architecture

安装后在 Claude Code 中输入/router-first-architecture确认已加载。

详细介绍

路由器优先架构

使用单个工具前,先通过领域路由器进行路由。路由器会抽象工具选择过程。

模式

领域路由器(如 math-router)提供从用户意图到精确 CLI 命令的确定性映射。始终先使用路由器;仅在边缘情况下绕过。

应该做

  • 执行任何数学运算前,先调用 math-router route "<intent>"
  • 通过 skill-rules.json 中的 coActivate,让领域技能与其路由器共同激活
  • 信任路由器的置信度评分;仅在 command: null 时回退
  • 让 skill-rules.json 中的触发关键词/模式比路由模式更宽泛

不应该做

  • 存在路由器时,直接调用单个脚本
  • 在单个技能中重复实现路由逻辑
  • 让领域技能绕过其路由器

共同激活模式

领域技能应与其路由器共同激活:

{
  "math/abstract-algebra/groups": {
    "coActivate": ["math-router"],
    "coActivateMode": "always"
  }
}

这样可确保激活领域知识时,路由器始终可用。

双层架构

  1. 技能规则触发层:提示 Claude 使用路由器(关键词、意图模式)
  2. 路由器路由层:通过正则表达式模式确定性地映射到脚本

让触发层比路由更宽泛——路由器应能妥善处理“未找到”的情况。

源会话

  • 2bbc8d6e:“触发层比路由层更窄”——扩展触发条件
  • 本次会话:将 8 个领域数学技能配置为与 math-router 共同激活

评论

支持 Markdown