用途
Toolkit Router 是一个元技能(meta-skill),用于在当前 ~/.claude 工具包中为手头任务找到合适的技能、智能体、命令、规则、清单或市场技能。该工具包中的大多数技能和命令只以名称形式列出,以保持上下文精简,但它们都已安装且可调用。本技能就是用来找到它们的方式。
主要能力
- 按关键词检索索引:~/.claude/INDEX.md 按领域分组,可用 grep 只读取匹配部分。
- 查询关系:通过 ~/.claude/index/graph.json 了解哪个智能体与哪个技能配对、哪条规则或清单适用。
- 选择并调用资源:最多选择一个主技能加一个专家技能;专家智能体是名为 agent-<name> 的技能,在独立子智能体中运行。
- 应用规则与清单:索引行中列出的 rules/*.md、docs/reference/** 等;路径作用域规则在读取匹配文件时自动加载。
- 检索市场目录:本地无匹配时,搜索 marketplace-catalog.json,并直接从 ~/.claude/plugins/marketplaces/… 读取所选市场的 SKILL.md。
- 兜底策略:仍无匹配时使用通用知识,不虚构技能名称。
使用方式
- 搜索索引,不要通读全文:
rg -n -i "<keyword>" ~/.claude/INDEX.md对于关系(哪个智能体与技能配对、哪条规则或清单适用),查询~/.claude/index/graph.json。 - 最多选择一个主技能加一个专家。用 Skill 工具(或
/name)调用。专家智能体是名为agent-<name>的技能,在各自子智能体中运行:当工作受益于独立上下文(广泛研究、独立审查、语言/框架专家)时,以任务为参数调用它们。 - 应用索引行中列出的匹配规则和清单(
rules/*.md、docs/reference/**)。路径作用域规则在读取匹配文件时自动加载。 - 本地无匹配时:搜索市场目录(市场被拉取后才会出现):
rg -i "<keyword>" ~/.claude/index/marketplace-catalog.json | head -20直接从~/.claude/plugins/marketplaces/…读取所选市场的SKILL.md并遵循它。 - 仍然没有:使用通用知识继续。不要虚构技能名称。
领域路由
对于多领域或模糊请求,routes/ 中的路由文件将意图映射到资源:
| 路由 | 文件 |
|---|---|
| 开发(Web、移动、后端、基础设施) | routes/domains-development.md |
| 商业与产品 | routes/domains-business.md |
| 创意与内容 | routes/domains-creative.md |
| 科学与研究 | routes/domains-scientific.md |
| 工具包 / 元 | routes/domains-meta.md |
| 决策与权衡 | routes/decision-frameworks.md |
| 复杂度评分 | routes/routing-logic.md |
保持索引最新
索引是生成的。在添加或更改技能、智能体、命令、规则或市场后,自行运行 node ~/.claude/scripts/generate-index.mjs --write;没有钩子会重新生成它(pre-commit 钩子只运行发布安全检查)。通过将技能添加到 index/tiers.json 可将其提升为完整描述的“核心”技能。
适用场景
- 任务属于专业领域(移动、安全、数据/ML、基础设施、商业、创意、研究),且没有明显匹配的已列技能。
- 被问及该工具包提供哪些能力。
- 需要查找与某任务相关的智能体、命令、规则或清单。
- 需要跨领域或模糊请求的路由指引。
限制
- 索引为生成产物,需手动运行脚本更新,无自动钩子重新生成。
- 市场目录仅在市场被拉取后才存在。
- 本地与市场均无匹配时,只能使用通用知识,不得虚构技能名称。
- 关于收费、价格、平台支持等具体信息,资料中暂未提供。