一款用於自動化程式碼庫探索、符號索引與架構視覺化的高效能工具。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install oc-codebase-intelligence
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 oc-codebase-intelligence。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 Codebase Intelligence？
Codebase Intelligence 是一個強大的分析引擎，旨在協助開發者掌握 Openclaw Skills 生態系統內的複雜軟體專案。它透過識別模組邊界、追蹤跨檔案依賴關係以及索引類別與函式等符號，提供任何儲存庫的技術映射。透過實作增量快取層，即使在大型程式碼庫中也能保持高效能，確保隨後的搜尋與查詢幾乎瞬間完成。
此技能透過提供對話式程式碼發現介面，彌合了原始原始碼與開發者理解之間的鴻溝。無論您是在瀏覽舊系統還是建構新功能，Codebase Intelligence 都能確保您擁有編寫更好程式碼所需的結構背景，從而提高效率。
Codebase Intelligence 應用場景
- 加入新專案或處理舊系統時，快速了解整體架構。
- 在重構模組之前進行影響分析，查看所有受影響的依賴項。
- 為技術文件或 Pull Request 審查生成最新的 Mermaid 圖表。
- 使用自然語言查詢定位特定邏輯的確切位置，例如身分驗證或支付流程。
Codebase Intelligence 運作原理
- 使用者使用 Openclaw Skills CLI 啟動分析，該工具會掃描專案根目錄並識別所有支援的原始碼檔案。
- 索引器提取符號（類別、函式、匯入）並映射不同檔案與模組之間的關係。
- 在 .codebase-intelligence 目錄中建立本機快取，以儲存元資料與依賴關係圖。
- 後續查詢使用此快取提供即時答案，僅更新自上次掃描以來發生變更的檔案。
- 用於圖表與依賴追蹤的專用模組將索引資料轉換為視覺化或結構化報告。
Codebase Intelligence 設定指南
要開始使用 Codebase Intelligence，請確保已安裝 Python 3。導航至您的專案目錄並執行以下指令：
# 導航至您的專案
cd /path/to/your/repo
# 執行初始程式碼庫分析並建立快取
python3 /path/to/codebase-intelligence/scripts/main.py analyze .
您可以選擇在專案根目錄中建立 .codebase-intelligence.json 檔案以排除特定目錄：
{
"ignore": ["node_modules", ".git", "dist"],
"entryPoints": ["src/main.py"]
}
Codebase Intelligence 資料結構與分類體系
此技能將其智慧資料組織在專案根目錄的一個隱藏資料夾中。資料結構如下：
| 檔案/目錄 | 用途 |
|---|---|
.codebase-intelligence/ |
所有技能相關元資料的根目錄。 |
codebase_index.pkl |
包含依賴關係圖與符號表的二進位序列化快取。 |
index.json |
可匯出的程式碼庫結構 JSON 表示，用於外部工具整合。 |
architecture.md |
(選用) 包含 Mermaid 圖表的生成的 Markdown 檔案。 |
Codebase Intelligence 進階特性
- 增量快取：自動偵測檔案變更，在幾毫秒內更新大型儲存庫的索引。
- 深度依賴追蹤：支援反向依賴查找，以找出依賴於特定工具或模組的所有檔案。
- 多語言支援：對 Python、JavaScript、TypeScript、Go 與 Java 進行完整的符號解析。
- CI/CD 整合：可整合至 GitHub Actions 中，在每次推送時自動生成架構圖。
- 智慧問答：專用的 ask 指令，使用關鍵字與關係匹配來回答有關專案的結構性問題。
SKILL.md
加載中
Openclaw 相關技能
精選*
