SuperAPI AI 工具集

ace-tool

编程与开发

查看项目

更新于 10-16 08:38

技能介绍

用途:Ace Tool 通过 MCP 提供语义化仓库检索,帮助回答“这个功能在哪里实现”这类问题,在退回到精确文本搜索或直接编辑之前先定位相关代码。主要入口为 mcp__ace_tool__search_context,参考说明见 skills/ace-tool/references/ace-tool.md。

适用场景:不知道逻辑位于哪些文件;需要某个功能、缺陷、工作流或子系统的跨文件上下文;编辑前想找相似实现或既有模式;需要测试、处理器、服务或集成点的整体地图。

不适用场景:精确标识符查找(如查找所有 fooBar 引用)、精确文件名搜索、已知且较小的文件(直接读取更快)。语义缩小范围后,精确字符串匹配应改用 rg、IDE 搜索等工具。

使用方式:写一条自然语言查询,描述行为、工作流和重要关键词;规划编辑时把相关符号放进同一查询;读取返回的文件路径与片段;位置明确后再做精确读取或编辑。查询风格建议行为优先,例如“服务器在哪里合并上传分块?”,末尾补充关键词以提高召回;需要测试时明确询问;一次查询可包含多个关联符号,避免拆成许多小查询。

限制与护栏:始终传入真实项目根路径;文件归属不确定时先使用 Ace Tool 再编辑;语义匹配不能当作证据,需通过直接读取文件验证。