Skill Router — 通用路由引擎
概述
Skill Router 是一个通用路由引擎,在每个非平凡任务执行前运行三问分类,将任务映射到最合适的 Skill、Agent 和 Model 组合。支持 2700+ 个 Skill 的路由。
输出格式:Skill + Agent + Model
适用场景
每个非平凡任务前都要运行——包括写代码、使用工具、回答复杂问题。不需要路由的场景:一行修复、读代码、一个事实性问题、一个命令、3步以内的简单操作。
使用方法
三问分类(5秒完成)
Q1: 有什么坏了/错了/失败了吗?
→ 错误、崩溃、测试失败、意外输出、用户纠正
YES → BROKEN 路径
Q2: 这是在创建/构建/新增什么东西吗?
→ 新功能、新文件、新组件、新集成、新页面
YES → BUILD 路径
Q3: 其他一切(改进、发布、配置、自动化、研究)
→ OPERATE 路径
模棱两可?→ 默认走更高复杂度的路径(BUILD)
BROKEN 路径
| 信号 | Skill | Agent | Model | Thinking |
|---|---|---|---|---|
| 错误/崩溃/异常 | systematic-debugging |
general-purpose | sonnet | think |
| 测试失败 | test-runner → systematic-debugging |
test-runner | sonnet | none |
| TypeScript 错误 | typescript-expert |
general-purpose | sonnet | none |
| 性能回退 | perf → systematic-debugging |
optimizer | sonnet | think |
| 安全问题 | security |
security-auditor | sonnet | think-hard |
| 部署/构建失败 | systematic-debugging |
general-purpose | sonnet | think |
| 用户说"不对" | 停止 → systematic-debugging |
general-purpose | sonnet | think |
| 生产事故 | systematic-debugging |
general-purpose | opus | ultrathink |
BUILD 路径
多文件/新功能:brainstorming → writing-plans → 领域 Skill
| 任务 | Skill | Agent | Model | Thinking |
|---|---|---|---|---|
| UI 组件/页面 | frontend-design |
code-architect | sonnet | none |
| API 端点 | feature-dev |
code-architect | sonnet | think |
| 数据库 Schema | db-expert |
db-expert | sonnet | think |
| 认证/权限 | brainstorming → security |
security-auditor | opus | ultrathink |
| AI 功能/Agent | brainstorming |
code-architect | sonnet | think-hard |
OPERATE 路径
| 信号 | Skill | Agent | Model | Thinking |
|---|---|---|---|---|
| 重构/清理 | refactor |
code-simplifier | sonnet | none |
| 添加测试 | test-driven-development |
test-runner | sonnet | none |
| 性能优化 | perf |
optimizer | sonnet | think |
| 代码审查 | requesting-code-review |
code-reviewer | sonnet | think-hard |
| 部署 | verification-before-completion |
general-purpose | sonnet | none |
| 2+独立任务 | dispatching-parallel-agents |
general-purpose | sonnet | none |
完成门
任何"完成"声明前 → verification-before-completion
□ 代码实际正确运行
□ TypeScript 通过 (tsc --noEmit)
□ 测试通过
□ 原始请求完全满足(重读一遍)
路由精度规则
- 无分类信号匹配时,路由输出静默——缺失
[skill-router]行意味着对话是简单的、探索性的或微不足道的 - 显式 slash 命令(如
/ship prod)时,路由静默——用户已自行选择了 Skill - 不要将静默默认解读为"OPERATE → 重构"
常见问题与陷阱
- "这很简单" → 简单任务路由只需5秒。跳过路由 = 浪费数小时
- "我知道该用什么" → 路由可以确认你的判断。5秒成本,零风险
- "表里没匹配" → 运行目录检查再放弃
- "我已经知道这个 Skill 了" → 还是运行目录检查——可能有更好的
- 不要改写输出格式 →
[skill-router]行和▶标记必须原样输出,这是可 grep 的契约
Thinking 深度前缀
| 值 | 前缀 |
|---|---|
none |
(无) |
think |
think. |
think-hard |
think hard. |
ultrathink |
ultrathink. |
验证清单
- [ ] 每个非平凡任务前运行了三问分类
- [ ] 输出格式包含
[skill-router]行 - [ ] 复杂度规则正确(1领域=1 Skill,2+领域=链式)
- [ ] 完成门在声称"完成"前通过
- [ ] Thinking 深度前缀正确