用途:当用户表达模糊或跨领域需求,询问“该用哪个技能”“有没有相关技能”时,skill-router 将自由文本意图与技能库中每个技能的名称、标签、领域和描述进行比对、排序,推荐最匹配的技能,让合适的技能一次性被激活,避免用户翻找目录或猜测。它是两层模型中的用户调用型编排器:自身不干活,只路由到负责执行的技能。
主要能力:匹配意图;消歧相似技能;判断某个目标是否有对应技能;展示排序候选及匹配原因。匹配通过查询词与技能名称、标签、领域、描述的词重叠来打分,名称与标签精确命中权重最高。它还读取仓库级目录 cli/skills.json(由 scripts/build_manifest.py 重新生成),因此始终反映当前技能库,不硬编码技能列表。
使用方式:运行 python scripts/route_skill.py "<用户目标>"。示例:python scripts/route_skill.py "plan a go-to-market for a new B2B feature";可用 --top 5 放宽结果数;可用 --domain finance 限定领域;可用 --format json 输出 JSON。若目录缺失,可用 --catalog <path> 指定或先运行 python scripts/build_manifest.py 重新生成。路由前应先确认用户的实际目标,并区分用户是要产出物还是只要建议;如果请求已足够具体,可跳过提问直接路由。
适用场景:目标模糊(如“帮我策划一次发布”);跨领域歧义(如“定价”可能属于产品、财务或增长);发现技能是否存在的探索;多个同名或相似技能间的消歧。
限制:不执行匹配技能的工作流,那是目标技能的职责;不做多技能顺序编排(参见 standards/ 编排协议和 agents/personas/);不负责安装或提取技能。它依赖仓库级目录 cli/skills.json,是库内导航工具,不是可单独下载的独立技能。若最高分很弱,应如实说明“没有强匹配”并给出最接近的领域,而不是强行推荐。应避免:代替目标技能执行工作、强行匹配、忽略产出与建议的区别、硬编码技能名称。