SuperAPI AI 工具集

agent-router-setup

智能体与模型

查看项目

更新于 10-15 20:24

技能介绍

用途:agent-router-setup 是 claude-brewcode/brewtools 插件中的安装/配置技能,负责安装、配置或移除 agent-router 钩子。该钩子为 PreToolUse(匹配 Agent)钩子,用于检查主循环是否为某次 spawn 选对了 agent,并在其选择了通用 agent 时重定向到真正的专家——来自 .claude/agents/ 的项目 agent,或 brewcode 专家。

主要能力:分两级。Tier 1 始终开启,为确定性检查,含 node 启动在内耗时小于 100 毫秒、零 token,注册形式为 command 类型、node 执行 ${CLAUDE_PROJECT_DIR}/.claude/hooks/agent-router.mjs、timeout 5 秒。Tier 2 为可选(level strict),由 LLM 裁决模糊选择,使用 claude-haiku-4-5-20251001、timeout 30。Tier 1 按顺序判断:非 Agent 工具放行;子 agent 发起的 spawn 放行;配置关闭或无法解析则放行;所选类型本身是项目 agent 放行;不在 genericTypes 上的专家或内置类型放行;描述或提示中出现 agent-router: override 则静默放行;强意图规则(针对产物的创作动词)会 deny 并指名专家;再按各 .claude/agents/*.md 的 frontmatter 打分,唯一明显胜出者则 deny,多个候选则给出提示,无匹配则静默放行;弱意图信号只提示不 deny;防循环守卫对同一 (session, 项目根, 任务) 最多 deny 一次;任何错误均 fail open。

使用方式:技能把 $ARGUMENTS 视为自由文本(俄/英),从中推断模式与范围,先输出 PLAN 块,再执行。所有 bash 块需先解析 BT_ROOT(从技能自身目录或插件缓存定位),资产位于 $BT_ROOT/skills/agent-router-setup/assets/,包括 INSTALL.md(运行手册)、agent-router.mjs(Tier 1 钩子,唯一复制进项目的文件)、judge-prompt.md(Tier 2 提示,内联进 settings.json)。范围仅限项目,绝不写入 ~/.claude/*。该钩子默认不注册,安装插件后需运行本技能才生效。

适用场景与限制:适用于仓库中已有手写领域专家 agent、但主循环习惯性选择 general-purpose 的情况。限制:Claude Code 并行运行同一事件的所有钩子,Tier 1 无法阻止 Tier 2 触发;没有可靠信号判断工具调用是否来自 Skill 内部;Tier 1 按触发词而非语义匹配,倾向放行;所有失败模式均 fail open;防循环标记位于 os.tmpdir(),若该目录不可用则 deny 降级为提示;deny 只是返回给模型的工具错误,不会打断回合,重试可通过。该技能为实验性,仅项目范围,无全局安装。具体安装命令与配置细节以 INSTALL.md 为准,资料未提供完整命令。