用途:Tool Search 解决传统工具加载方式上下文占用过高、难以扩展到上百个工具的问题。传统方式会把全部工具一次性加载(例如 58 个工具约 55K tokens),而该技能只初始加载 Tool Search 工具本身(约 500 tokens),再根据任务语义按需搜索并展开相关工具。
主要能力:语义化工具搜索,按任务上下文查找相关工具;基于嵌入的匹配;按需加载,每次搜索通常加载 3-5 个相关工具(约 3K tokens);上下文效率提升。资料称工具定义 token 减少约 85%,总上下文占比从 87% 降至约 52.5%,工具选择准确率提升约 11%(79.5%→88.1%,Opus 4.5)。
使用方式:在 .claude/.mcp.json 中启用 toolSearch(enabled、autoEnableThreshold、defaultDeferLoading),并为 MCP 服务器设置 deferLoading 与 alwaysLoadTools,保留 3-5 个高频核心工具常驻。命令行示例:node .claude/tools/tool_search.mjs --query "git";可加 --limit 3。工作流为智能体先搜索能力,再由 Tool Search 返回匹配工具并展开为完整定义后使用。可与 Programmatic Tool Calling 配合。
适用场景:工具定义超过 10K tokens、工具库有 10 个以上工具、工具选择准确率有问题、使用多 MCP 服务器的系统。工具较少或每个会话常用全部工具时收益较低。
限制:需清晰命名与描述工具,需维护工具索引并监控使用情况;配置键与命令须按资料原样使用,其他环境细节暂未提供。