file-search

file-search 技能是一款高效能工具，專為開發者與 AI 代理設計，用於導航、稽核與分析複雜的程式碼庫。透過整合基於文字模式的搜尋與語法感知的結構化比對，顯著縮短了尋找程式入口點、識別使用模式或檢測安全性漏洞的時間。此技能建立在 ripgrep 與 ast-grep 等高效能引擎之上，這些引擎針對大規模專案的索引與檢索進行了優化，效能遠超傳統的 grep 或 find 指令。

• 使用 ripgrep (rg) 進行超高速的文字搜尋，涵蓋變數名稱、字串、註解以及多檔案與目錄中的正規表示式比對。

• 利用 ast-grep (sg) 執行進階的語法感知結構化搜尋，透過比對抽象語法樹 (AST) 來尋找函式簽章、類別定義或複雜程式碼區塊，而不受格式化差異影響。

• 支援快速程式碼發現，例如在安全性稽核期間尋找 TODO、FIXME、特定的 API 呼叫或硬編碼的敏感憑證。

• 強化重構工作流，在進行結構性變更前，精確定位對特定類別、方法或依賴項的所有交叉引用。

• 支援大規模程式碼分析，透過語言特定旗標、排除目錄的 glob 模式以及目錄層級的範圍設定，確保結果的高度相關性。

• 實作專業搜尋工作流，例如計算匹配數量、將輸出透過管道導向 head 進行取樣檢查，以及使用邊界限制 (word boundaries) 來確保精確匹配。

• 請務必以目標明確、縮小範圍的方式開始搜尋，以避免淹沒上下文視窗並造成 token 浪費。

• 推薦使用漸進式精煉工作流：先確定一般範圍，接著透過檔案類型（例如 --type py, --lang js）與目錄進行過濾，最後再套用複雜的正規表示式或結構化模式。

• 進行複雜重構時，請優先使用 ast-grep 的語意感知能力，而非僅依賴文字搜尋，以確保匹配的程式碼具備實際的語意關聯性。

• 時刻注意 token 消耗；在請求完整內容前，應先將大型結果集導向 head 或進行計數，以驗證搜尋密度。

• 確保環境隔離；此技能專門針對 MassGen 執行框架進行了優化，並利用容器環境中預先配置的二進位工具。