SKILL.md
唯讀
名稱
ccc
描述
此技能應在需要程式碼搜尋時使用（無論是明確要求還是作為完成任務的一部分）、在變更後為程式碼庫建立索引時，或當使用者詢問 ccc、cocoindex-code 或程式碼庫索引時。觸發詞包括「搜尋程式碼庫」、「尋找與...相關的程式碼」、「更新索引」、「ccc」、「cocoindex-code」。
ccc - 語意程式碼搜尋與索引
ccc 是 CocoIndex Code 的命令列工具，提供對目前程式碼庫的語意搜尋與索引管理。
所有權
代理擁有目前專案的 ccc 生命週期 — 初始化、索引與搜尋。不要要求使用者執行這些步驟，請自動處理。
- 初始化：如果
ccc search或ccc index因初始化錯誤而失敗（例如「不在已初始化的專案目錄中」），請從專案根目錄執行ccc init，然後執行ccc index建立索引，最後重試原始命令。 - 索引新鮮度：透過執行
ccc index（或ccc search --refresh）保持索引更新，當索引可能過期時 — 例如在會話開始時，或進行重大程式碼變更後（新增檔案、重構、重新命名模組）。如果連續搜尋之間沒有程式碼變更，則無需重新索引。 - 安裝：如果找不到
ccc本身（命令未找到），請參閱 management.md 的安裝說明並通知使用者。
搜尋程式碼庫
執行語意搜尋：
ccc search <查詢詞>
查詢應描述要尋找的概念、功能或行為，而非確切的程式碼語法。例如：
ccc search 資料庫連線池
ccc search 使用者認證流程
ccc search 錯誤處理重試邏輯
篩選結果
-
依語言（
--lang，可重複）：將結果限制為特定語言。ccc search --lang python --lang markdown 資料庫架構 -
依路徑（
--path）：將結果限制為相對於專案根目錄的 glob 模式。如果省略，預設為目前工作目錄（僅返回該子目錄下的結果）。ccc search --path 'src/api/*' 請求驗證
分頁
結果預設為第一頁。要取得更多結果：
ccc search --offset 5 --limit 5 資料庫架構
如果所有回傳的結果看起來都相關，請使用 --offset 取得下一頁 — 第一頁之外很可能還有更多有用的匹配。
處理搜尋結果
搜尋結果包含檔案路徑與行號範圍。要更詳細地檢視結果：
- 使用編輯器內建的檔案讀取功能（例如
Read工具）載入匹配的檔案，並讀取回傳範圍附近的行以取得完整上下文。 - 在沒有檔案讀取工具的終端機中工作時，使用
sed -n '<start>,<end>p' <file>提取特定行號範圍。
設定
若要檢視或編輯嵌入模型設定、包含/排除模式或語言覆蓋，請參閱 settings.md。
管理與疑難排解
有關安裝、初始化、守護行程管理、疑難排解與清理命令，請參閱 management.md。
