用途:当需要查找某个符号、字符串、环境变量或错误码在整个代码库中的定义或引用位置时使用。
主要能力:仓库范围快速搜索;支持按文件夹或模式用 glob 缩小范围;用 grep 做广泛发现,再对最佳匹配做定向读取;结果按相关性排序,返回 path:line 引用和简短说明。
使用方式:先确定精确搜索关键词及可能的变体;用 glob 按文件夹或模式限定范围;执行 grep 并按相关性排序;返回最佳匹配及 path:line 和简短备注。输出为定义与主要用法的 path:line 引用,并附下一步或可能需检查的主文件提示。示例:查找 PrefixJtiBlacklist 定义时搜索 config/ 中的常量;查找哪些文件引用 ACTIVATE_JWT 时在 config/、setTestEnv.sh、.env.sample 中 grep。
限制:只读,不修改文件。相关技能:code-navigation(影响映射)、file-reader(详细读取)。