SuperAPI AI 工具集

file-search

智能体与模型

查看项目

更新于 10-16 00:06

技能介绍

用途:file-search 技能让智能体在代码库中搜索文本模式或结构化代码模式,用于理解新代码库、查找函数/类/变量的所有用法、定位特定代码结构、排查安全问题、分析依赖导入以及查找 TODO/FIXME 注释。

主要能力:提供两个预装工具。ripgrep(rg)用于超快速文本搜索,支持正则,适合字符串、注释、变量名等文本匹配;ast-grep(sg)用于基于抽象语法树的结构化搜索,适合函数签名、类定义等语法感知匹配。两者都比传统 grep 或 find 更快。

使用方式:在 MassGen 中通过 execute_command 工具调用,例如 execute_command("rg 'pattern' --type py src/") 或 execute_command("sg --pattern 'class $NAME { $$$ }' --lang python")。两个工具已预装在 MassGen Docker 容器中,可通过 shell 执行。rg 常用参数包括 -i(忽略大小写)、-w(全词匹配)、-l(仅文件名)、-n(行号)、-C 3(上下文)、--count(计数)、--glob(排除目录)。sg 使用元变量 $VAR 匹配单个 AST 节点、$$$ 匹配零个或多个节点。

适用场景:理解新代码库入口与关键类、重构前查找用法、定位错误处理或 API 调用、搜索硬编码凭据或 eval 等安全问题、分析依赖导入、查找代码注释。

限制与建议:应始终从窄范围搜索开始,指定文件类型(--type 或 --lang)、限定目录、使用具体模式,并用 head 限制结果数量,避免返回数千条匹配导致分析困难。结果过多时可加类型过滤、缩小目录、细化模式、使用词边界或排除测试文件。无匹配时检查类型过滤或改用 -i;速度慢时用 --glob 排除目录。资料未提供该技能的收费、价格或平台支持信息。