Skill Router 是一个技能路由类工具,用于把用户的智能体请求推荐到“最窄匹配”的便携技能上。它主要在用户询问“我该用哪个技能?”、“什么技能能帮助……”、只说了“使用一个技能”却未指定具体技能、表达了需求但不确定哪个技能合适,或提到“skill router”“帮我找一个技能”时激活。
用途与定位
Skill Router 的核心用途是帮助用户在受支持的宿主环境中选择正确的技能。资料强调:不要假设当前会话中不可见的 Claude Code、Codex、Gemini 或 DeepSeek Harness 能力。也就是说,路由只在当前宿主已暴露的技能范围内进行。
主要能力
- 意图分析:识别用户想完成的任务类型、工作领域(Web、移动端、数据等)以及复杂度(简单任务还是复杂工作流)。
- 技能匹配:通过关键词匹配、语义相似度和上下文感知(项目状态与先前操作)把意图对应到最相关的技能。
- 交互式澄清:当请求模糊时,提出针对性问题,如主要目标是什么、期望什么类型的输出、是否有特定约束或偏好。
- 推荐与执行:给出推荐技能的名称与简要说明、推荐理由,并提供继续执行或查看其他选项的选择。
可用技能目录(资料中列出)
- 元与工作流:skill-router(为任务寻找并选择合适的技能)、create-pr(创建带双语文档检查的 pull request)、session-logger(保存会话摘要与活动日志)、workflow-orchestrator(协调多技能工作流与触发器)、self-improving-agent(从已完成的技能工作流中学习)、auto-trigger(声明技能之间的触发关系)。
- 核心开发:commit-helper(编写 Git 提交信息、格式化提交)、code-reviewer(审查 PR、代码变更与质量检查)、debugger(诊断缺陷、错误与异常行为)、refactoring-specialist(改善代码结构、减少技术债)。
- 文档与测试:documentation-engineer(编写 README、技术文档与代码文档)、api-documenter(创建 OpenAPI/Swagger 规范)、test-automator(编写测试、搭建测试框架)、qa-expert(测试策略、质量门禁与 QA 流程)。
- 架构与 DevOps:api-designer(设计 REST/GraphQL API 与 API 架构)、security-auditor(安全审计、漏洞审查、OWASP Top 10)、performance-engineer(性能优化与速度分析)、deployment-engineer(CI/CD 流水线与部署自动化)。
- 规划与分析:prd-planner(创建 PRD,并采用持久化文件规划)、prd-implementation-precheck(在实现前预检 PRD/规范)、architecting-solutions(非 PRD 的解决方案设计、架构与需求分析)、planning-with-files(多步骤任务规划与持久化文件组织)、long-task-coordinator(需要显式状态与恢复的多会话、委派或可续作工作)。
- 设计与 UX:figma-designer(分析 Figma 设计并产出可直接实现的可视化规范/PRD)。
路由流程
第一步是意图分析,识别任务类型、上下文与复杂度。第二步是技能匹配,依据关键词、语义相似度与上下文。第三步是交互式澄清,用问题缩小范围。第四步是推荐与执行,展示推荐技能、推荐理由,并允许用户继续或查看替代方案。
路由示例
- 清晰意图:用户说“我需要审查这个 pull request”,关键词是“review”“pull request”,意图是代码审查,推荐 code-reviewer。
- 模糊意图:用户说“用一个技能帮我做项目”,路由会询问正在做哪类任务,是在设计、编码、测试还是写文档,再据此推荐。
- 多技能场景:用户说“我在构建一个新 API,需要全流程帮助”,会建议按顺序组合:api-designer 设计 API 结构、api-documenter 用 OpenAPI 记录端点、test-automator 搭建 API 测试、code-reviewer 审查实现。
交互问题模板
当意图不清晰时,可使用以下问题模式:目标澄清(“你想通过这个任务完成什么?”“理想结果是什么样?”)、领域识别(“这属于开发、测试、文档还是部署?”“你在处理代码、API、基础设施还是其他?”)、阶段评估(“你处于规划、实现、测试还是维护阶段?”)、偏好确认(“你想要快速方案还是全面方案?”“你在使用特定工具或框架吗?”)。
最佳实践与高级模式
最佳实践包括:先宽后窄,从通用类别问题开始再深入细节;解释推荐理由以建立信任;提供首选推荐并提到 1–2 个替代方案;处理没有完美匹配的边缘情况;结合先前交互与用户偏好进行学习。高级路由包括语义路由,例如“清理我的代码”对应 refactoring-specialist、“让我的应用更快”对应 performance-engineer、“检查安全问题”对应 security-auditor、“恢复被中断的工作流”对应 long-task-coordinator;以及多技能编排,例如新功能用 architecting-solutions → debugger → code-reviewer,API 项目用 api-designer → api-documenter → test-automator,生产就绪用 security-auditor → performance-engineer → deployment-engineer。
置信度与错误恢复
置信度分为高(直接关键词匹配、意图清晰)、中(语义相似、合理推断)、低(请求模糊、需要澄清)。如果推荐的技能不合适,应承认不匹配、追问以细化理解、提供替代推荐,必要时回退到通用协助。
输出格式
推荐技能时使用固定格式:## Recommended Skill: {skill-name},说明推荐理由;What it does: 一句技能描述;Best for: 具体用例;最后询问是激活该技能还是查看其他选项。
限制
该技能只在当前宿主已暴露的技能范围内路由,不假设会话中不可见的能力;资料中未提供其收费、价格、平台支持细节或具体安装命令,这些内容暂未提供。