长亭百智云长亭百智云
登录
返回全部 Skills

skill-router

知识检索

此技能适用于用户提出模糊或跨域请求，例如“我应该使用哪个技能”、“有这个技能吗”、“找到合适的技能”或“将其路由到最佳技能”——它会将意图与整个技能库进行匹配，并推荐最合适的技能。

2

下载量

AI SkillHub 能力展示图

安装方式

命令行安装

在项目根目录执行以下命令，完成 Skill 安装。

npx bzskills add borghei/claude-skills --skill skill-router

skill.md

name: skill-router
description: 此技能适用于用户提出模糊或跨域请求，例如“我应该使用哪个技能”、“有这个技能吗”、“找到合适的技能”或“将其路由到最佳技能”——它会将意图与整个技能库进行匹配，并推荐最合适的技能。
license: MIT + Commons Clause
metadata:
    version: 1.0.0
    author: borghei
    category: workflow
    domain: orchestration
    updated: 2026-06-22
    python-tools: route_skill.py
    tags: [router, discovery, orchestration, navigation, intent-matching]

Skill Router

概述

本库拥有横跨十六个领域的数百项技能。用户很少知道确切的技能名称 —— 他们了解自己的*意图*（“我需要弄清楚下个季度该做什么”、“我必须响应一次数据泄露”）。路由模块弥合了这一差距：它将自由文本请求与每项技能的描述和标签进行匹配，对候选项进行排序，并推荐最佳匹配 —— 这样正确的技能在第一次尝试时就能激活，而无需用户去翻查文件夹或猜测。

在两层模型中，它是用户调用的编排器：它自身从不执行具体工作，而是将请求路由到能够完成工作的技能（专业领域）。将其输出视为推荐，然后激活所选技能。

使用场景

  • 模糊意图 —— 用户描述了一个目标，但没有指明具体技能（“帮我规划一次产品发布”）。
  • 跨领域歧义 —— 请求可能合理属于多个领域（“定价”属于产品管理、财务还是业务增长？）。
  • 探索发现 —— 用户询问是否存在适用于某目标的技能，而不是先假设没有。
  • 消歧义 —— 存在多个名称相似的技能（例如多个PRD或CRO技能），需要找到最接近的匹配。

先澄清再路由

在路由前，请确认以下输入。如果任何一项未知或模糊，请询问 —— 不要假设：

  • [ ] 实际目标 —— 用户期望达到的结果，用他们自己的话描述（路由模块匹配的是意图，因此模糊的目标会产生模糊的匹配）
  • [ ] 制品还是建议 —— 他们想要*产出*某个东西，还是*决定/理解*某个东西（区分生成型技能与咨询型技能）

停止规则：如果请求已经明确，则跳过这些问题，直接进行路由。

快速开始

# 为某个意图推荐最佳匹配技能
python scripts/route_skill.py "为新的B2B功能制定上市策略"

# 限定领域，或扩大结果集
python scripts/route_skill.py "响应数据泄露" --top 5
python scripts/route_skill.py "预测收入" --domain finance --format json
  1. 对生成的目录（cli/skills.json）运行 route_skill.py "<用户的目标>"。
  2. 查看排序后的候选技能及其匹配原因。
  3. 选择最佳匹配（如果确实存在歧义，可展示前2-3个）并激活该技能 —— 不要在路由模块中完成工作。
  4. 如果没有技能得分较高，请直说“没有强匹配”，并建议最接近的领域，而不是强行匹配一个弱关联的候选。

匹配机制

脚本通过计算查询内容与技能名称、标签、领域和描述之间的术语重叠度来为每个技能评分，对确切的名称/标签匹配给予最高权重。脚本从cli/skills.json（由scripts/build_manifest.py重新生成）读取目录，因此始终反映当前库的状态，无需硬编码任何技能列表。

反模式

  • 在路由中完成工作而非路由。 路由模块负责推荐；推荐的技能负责执行。不要混淆两者。
  • 强行匹配。 如果最高分较低，就说“没有强匹配” —— 一个自信但错误的路线比诚实的失败更糟糕。
  • 忽略制品与建议的区分。 将“生成一份PRD”的意图路由到咨询型角色（或反之）会浪费用户的时间。
  • 硬编码技能名称。 始终读取实时目录；库会发生变化。

范围与限制

范围内： 将自由文本意图与技能目录进行匹配，并推荐最佳匹配技能；对相似技能进行消歧义；确认是否存在适用于某目标的技能。

范围外： 执行匹配到的技能的工作流（这是目标技能的任务）；跨多个技能的工作流编排（参见standards/下的编排协议和agents/personas/）；安装或提取技能。

依赖说明： 路由模块读取仓库级别的目录cli/skills.json。它是库内使用的导航辅助工具，并非独立的单技能下载 —— 如果目录不存在，请使用--catalog <path>参数指定路径，或使用python scripts/build_manifest.py重新生成。

参考

  • scripts/route_skill.py —— 基于cli/skills.json的意图到技能评分器。