本地程式碼搜尋
安裝與注意事項
當工具缺失、在其他機器上安裝此技能、檢查加速或更新時，請閱讀設定與疑難排解。不要因為一般程式碼任務呼叫此技能就安裝或重新配置工具。可選的可攜式 cgrep 輔助工具 提供搜尋旗標；平台特定的設定與其限制在 setup 文件中說明。
從輪廓開始
在編寫程式階段開始時，以及在調查重構或複雜程式碼問題之前，請先閱讀儲存庫的指示與相關專案指引，然後使用限定的輪廓作為首次程式碼導航步驟，再進行廣泛的原始碼讀取或實作規劃。請閱讀輪廓子指南。
選擇最小相關的套件、目錄或檔案；預設不要對整個單一儲存庫進行輪廓化。如果區域未知，請使用檔案名稱或重點 ColGREP 查詢來尋找候選項目，然後再對其進行輪廓化。重複使用本會話中已存在的輪廓；在結構性編輯後重新整理受影響的檔案。簡單的精確查詢、對已理解程式碼的小幅度修改以及非程式碼的對話可以直接進行。這是一種工作習慣，而非背景流程或每次轉換的掃描。
選擇下一個工具
根據對目標已知的資訊進行選擇，並僅閱讀相關的子指南。這些指南屬於此技能，而非獨立的技能註冊。
| 需求 | 工具 | 子指南 |
|---|---|---|
| 會話輪廓、重構範圍或複雜程式碼調查 | ast-grep outline | 先輪廓 |
| 精確字串、錯誤訊息、檔案名稱或簡單識別碼出現處 | rg | 精確搜尋 |
| 從行為描述尋找實作 | ColGREP / cgrep | 語意發現 |
| 語法、程式碼結構內的關係、可重複的語法式變更 | ast-grep | 結構化搜尋 |
當相關區域已知時，從狹窄的檔案或目錄範圍開始。使用 ColGREP 發現候選項目、使用 rg 檢查已知符號、再使用 ast-grep 精煉語法模式是正常的。不要自動執行全部三個工具。使用原生的代理工具進行檔案讀取/編輯、測試與 git 操作。
搜尋結果定位候選項目；在做出行為斷言之前，請檢查相關的原始碼。不要將語法配對視為類型解析的參考。
一個標準安裝可服務於 Codex 和 Claude Code。在此維護工具指南；不要重新安裝獨立的工具技能或啟動重複的搜尋掛鉤。