**参考文献（存档）：** [SCAFFOLD_SKILLS_ARCHIVE_MAP.md]() — 从 everything-claude-code 发现嵌入/语义工具后端模式、TDD 工作流程。 # 工具搜索技巧 ## 身份工具搜索 - 使用嵌入提供语义工具发现，从数十个工具扩展到数千个工具，上下文减少了 90% 以上。 ## 能力 * **语义工具搜索** ：根据任务上下文查找相关工具 * **基于嵌入的匹配**：使用嵌入进行准确的工具发现 * **按需加载**：仅在需要时加载工具 * **上下文效率**：工具定义标记减少 90% 以上 ## 问题传统刀具装载： * 所有工具均预先加载 * 58 个工具 = ~55K 代币 * 上下文很快就填满了 * 很难扩展到超过 100 个工具 ## 解决方案带嵌入的工具搜索： * 最初仅加载工具搜索工具（约 500 个令牌） * 通过语义搜索按需发现的工具 * 每次搜索加载 3-5 个相关工具（~3K 令牌） * 总计：约 8.7K 代币 vs. 约 77K 传统代币（减少 85%） ## 它是如何工作的 1. **初始状态**：仅加载工具搜索工具+关键工具 2. **工具发现**：Agent根据任务搜索工具 3. **语义匹配**：嵌入将工具与任务上下文匹配 4. **工具扩展**：匹配工具扩展为完整定义 5. **工具使用**：代理使用发现的工具 ## 配置 ### MCP 配置（`.claude/.mcp.json`） { "betaFeatures": ["高级工具使用-2025-11-20"], “工具搜索”：{ “启用”：正确， “自动启用阈值”：20， “defaultDeferLoading”：true }, “mcp服务器”：{ “回购”：{ “延迟加载”：正确， “alwaysLoadTools”：[“搜索代码”，“读取文件”] }, “github”：{ “延迟加载”：正确， “alwaysLoadTools”：[“create_pull_request”，“get_issue”] } } } ### 始终加载关键工具始终加载 3-5 个最常用的工具： * 核心文件操作：`read_file`、`write_file`、`search_code` * 基本集成：`create_pull_request`、`get_issue` * 常用：`take_screenshot`、`navigate_page` ## 使用模式 ### 何时使用工具搜索 **最有利的时候**： * 工具定义消耗 >10K 代币 * 工具库有10+工具 * 遇到刀具选择精度问题 * 使用多台服务器构建 MCP 驱动的系统 **当**时效果较差： * 小型工具库（<10 个工具） * 每个会话中经常使用的所有工具 * 工具定义紧凑 ### 工具发现 **代理工作流程**： 1. 代理需要能力（例如，“创建拉取请求”） 2.代理搜索：“github拉取请求创建” 3.工具搜索返回：`create_pull_request`工具 4.工具扩展为完整定义 5. 代理使用工具 **示例**：用户：“为我的更改创建拉取请求” 代理搜索：“github 拉取请求创建” 工具搜索发现：create_pull_request 工具工具加载和使用 ## 最佳实践 ### 1\.清晰的工具名称和描述 **好**： { “名称”：“搜索客户订单”， "description": "按日期范围、状态或总金额搜索客户订单。返回订单详细信息，包括商品、运输和付款信息。" } **不好**： { “名称”：“query_db_orders”， "description": "执行订单查询" } ### 2\.系统提示指导在代理提示中添加指导：您可以使用 Slack 消息传递、Google Drive 文件管理等工具 Jira 票证跟踪和 GitHub 存储库操作。使用工具搜索在需要时找到特定的功能。 ### 3\.保持关键工具始终处于加载状态不要推迟加载： * 核心文件操作 * 必要的集成 * 常用工具 ### 4\.监控工具使用情况跟踪发现了哪些工具： * 搜索最多的工具 * 工具发现模式 * 实现上下文节省 ## 实施 ### 基于嵌入的工具搜索工具搜索使用嵌入来将工具与查询相匹配： 1. **工具索引**：为所有工具定义创建嵌入 2. **查询嵌入** ：为用户查询创建嵌入 3. **相似性搜索**：查找具有相似嵌入的工具 4. **工具扩展**：将匹配的工具加载到上下文中 ### 工具搜索工具工具搜索工具本身： * 语义搜索工具库 * 根据查询返回相关工具 * 将工具扩展为完整的定义 * 维护工具索引 ## 好处 ### 上下文效率 * **工具定义标记减少 85%** * **总上下文占 52.5%**（低于 87%） * **在最佳范围内**（60-70% 目标） ### 提高准确性 * **刀具选择精度提高 11%** * **79.5% → 88.1%** (作品 4.5) * 为复杂查询提供更好的工具匹配 ### 可扩展性 * 可扩展至**数千种工具** * 没有上下文限制问题 * 动态工具发现 ## 示例 ### 示例 1：GitHub 操作用户：“创建拉取请求” 代理工作流程： 1.搜索：“github拉取请求创建” 2.工具搜索找到：create_pull_request工具 3. 工具加载（3K 代币） 4. 代理使用工具 5. 总上下文：约 8.7K 代币（相对于 55K 传统代币） ### 示例2：文件操作用户：“搜索验证码” 代理工作流程： 1.搜索：“代码搜索文件操作” 2.工具搜索找到：search_code、read_file工具 3. 工具加载（5K 代币） 4. 代理使用工具 ### 示例 3：多重集成用户：“检查 Slack 消息并创建 Jira 票证” 代理工作流程： 1.搜索：“slack消息阅读” 2.工具搜索找到：read_slack_message工具 3.搜索：“jira Ticket创建” 4.工具搜索找到：create_jira_ticket工具 5. 两个工具均已加载（总共 6K 代币） ## 整合 ### 使用 MCP 服务器工具搜索适用于 MCP 服务器： * GitHub MCP：35 个工具 → 3-5 个按需加载 * Slack MCP：11 个工具 → 2-3 个按需加载 * 自定义 MCP：任意数量的工具 → 根据需要加载 ### 带代理系统所有代理都受益于工具搜索： * 减少上下文使用 * 更好的工具选择 * 可扩展的工具库 ## 故障排除 ### 未找到工具 * 检查工具名称和描述是否清晰 * 验证工具搜索已启用 * 查看搜索查询 * 检查工具索引是否是最新的 ### 背景仍然很高 * 验证 deferLoading 是否启用 * 检查alwaysLoadTools列表（应该是最小的） *审查工具定义（可能太冗长） * 监控实际工具使用情况 ### 工具选择问题 * 改进工具描述 * 为搜索查询添加更多上下文 * 检查工具命名约定 * 检查嵌入质量 ## 与编程工具调用 (PTC) 集成工具搜索与编程工具调用完美配合： 1. **工具搜索**找到相关工具（按需加载） 2. **PTC** 高效地编排工具（减少上下文） 3. **结果**：以最少的代币消耗实现最佳的工具使用 **工作流程示例**： # 工具搜索找到工具工具 = search_tools("github 问题管理") # PTC 协调多个工具调用团队=等待 get_team_members(“工程”) 问题 = 等待 asyncio.gather(*[ get_issue(member["github_username"]) 对于团队中的成员 ]） # 只有上下文中的最终结果，而不是所有中间数据有关全面的 PTC 文档，请参阅 [PTC 模式指南]()。 ## 相关文档 * [高级工具使用]() \- 综合工具使用指南 * [PTC 模式]() \- 编程工具调用模式 * [上下文优化]() \- 上下文管理 ## 参考文献 * [带有嵌入的工具搜索手册]() * [编程工具调用手册]() * [高级工具使用文档]() # 搜索git相关工具节点.claude/tools/tool_search.mjs --query“git” # 搜索数据库工具节点.claude/tools/tool_search.mjs --查询“数据库”--限制 3 # 搜索测试工具节点.claude/tools/tool_search.mjs --query“测试” ## 内存协议（强制） **开始之前：**阅读 `.claude/context/memory/learnings.md` **完成后：** * 新模式 -> `.claude/context/memory/learnings.md` * 发现问题 -> `.claude/context/memory/issues.md` * 做出决定 -> `.claude/context/memory/decisions.md` > 假设中断：如果它不在内存中，则它没有发生。

工具搜索

包含技能