file-search

file-search 技能透过整合 ripgrep 与 ast-grep，使代理程序能够高效地导航与分析大型代码库。ripgrep 用于基于文本的正则表达式搜索，而 ast-grep 则用于结构化、语法感知的代码比对。此工具专为开发者与 AI 代理设计，适用于代码探索、重构、安全性稽核与技术文档分析，能帮助使用者在无需人工遍历的情况下快速定位入口点、追踪函数或类用法。

• 进阶文本搜索：支援透过 ripgrep 进行多文件正则表达式搜索，快速定位字符串、变量名称、注释与配置键。

• 语法感知分析：利用 ast-grep 基于抽象语法树 (AST) 执行语义代码搜索，可精准比对类定义、函数签名与复杂代码区块。

• 高效性能架构：专为大型存储库设计，在搜索速度与效率上远优于传统的 grep 或 find 指令。

• 广泛语言支援：支援针对 Python、JavaScript、TypeScript 等多种编程语言进行精确的范围搜索。

• 优先执行目标明确的搜索：建议透过指定目录路径或文件类型筛选器（如 --type py）来锁定搜索范围，以维持高精确度并减少 Token 消耗。

• 流程优化：建议先使用计数功能评估范围，再透过前后文标记或更具体的语法模式缩小范围，以精准找到所需的代码逻辑。

• 安全性稽核：可利用此工具主动识别安全性漏洞，例如硬编码凭证、潜在注入点或危险函数（如 eval）的使用。

• 工具选择建议：对于简单的文本字符串、注释或一般模式比对，请优先选择 ripgrep；若搜索重点在于代码逻辑或语法结构，请优先使用 ast-grep。

• 性能调整建议：扫描大量结果时，务必将输出透过 pipe 传递给 head 指令，以避免过度消耗代理上下文空间；同时可使用 --glob 标记排除测试目录或不相关的资源。