一個 AI 驅動的 SQL 專家，用於解釋執行計畫、優化查詢並將自然語言轉換為資料庫指令。
安裝與下載
1. ClawHub CLI
從來源直接安裝技能的最快方式。
npx clawhub@latest install sql-explain-kay
2. 手動安裝
將技能資料夾複製到以下位置之一
~/.openclaw/skills/ <project>/skills/ 優先級：工作區 > 本地 > 內建
3. 提示詞安裝
將此提示詞複製到 OpenClaw 即可自動安裝。
請幫我使用 Clawhub 安裝 sql-explain-kay。如果尚未安裝 Clawhub，請先安裝（npm i -g clawhub）。
想要直接下載？
取得包含原生技能檔案的ZIP壓縮檔。
什麼是 SQL Query Explain？
SQL Query Explain 是一項全面的 AI 編碼代理技能，旨在彌補複雜資料庫查詢與開發人員效率之間的鴻溝。作為 Openclaw Skills 生態系統的核心部分，它充當虛擬 SQL 專家，為 PostgreSQL、MySQL 和 SQLite 提供關於查詢執行計畫的深度洞察。無論您是在排查緩慢的效能問題，還是需要根據自然語言描述生成標準 SQL，此技能都能簡化資料庫開發生命週期。
透過利用 sqlparse 等本地解析庫，該技能在提供高度技術性與可操作性回饋的同時，確保了資料隱私。它不僅限於簡單的格式化，還能識別全表掃描與巢狀迴圈等昂貴操作，幫助開發人員在支援 Openclaw Skills 的工作流程中有效地實施基於索引的優化。
SQL Query Explain 應用場景
- 分析執行緩慢的查詢，以識別缺失的索引或低效的連線類型。
- 將以純文字描述的複雜業務需求轉換為可執行的 SQL 陳述式。
- 格式化並美化雜亂的舊有 SQL 程式碼，以提高可讀性與維護性。
- 除錯 SQL 指令碼中的語法錯誤，並提供可操作的修正建議。
- 在生產環境中執行查詢之前，了解其開銷與估計的行數影響。
SQL Query Explain 運作原理
- 使用者透過支援 Openclaw Skills 的平台提供 SQL 查詢或自然語言描述。
- 該技能識別具體意圖：是解釋、生成、格式化還是檢查語法。
- 對於效能分析，它利用 sqlparse 建構語法樹，並應用內建規則集來解讀 EXPLAIN 輸出。
- 它評估資料表掃描方法、索引使用情形與連線策略，以計算查詢開銷與效能瓶頸。
- 它生成一份結構化的效能報告，包括具體的優化建議與供開發人員使用的格式化程式碼。
SQL Query Explain 設定指南
要將此技能整合到您的環境中，請確保已安裝 Python 與必要的解析庫。
# 安裝所需的相依套件
pip install sqlparse
# 若使用 sqlean 模組進行擴充分析
pip install sqlean
安裝完成後，將 SQL Query Explain 觸發關鍵字新增至您的代理設定中，以啟用該技能功能。
SQL Query Explain 資料結構與分類體系
該技能處理 SQL 字串並返回按執行指標與優化規則分類的結構化報告。以下是報告中使用的元資料分類：
| 屬性 | 描述 |
|---|---|
| Total Cost | 根據資料庫引擎計畫所計算出的估計執行開銷。 |
| Scan Type | 識別 Seq Scan、Index Scan、Index Only Scan 或 Full Table Scan。 |
| Row Estimation | 查詢所處理的估計列數與實際列數。 |
| Performance Issues | 已識別的瓶頸列表，例如昂貴的連線或缺失的索引。 |
| Optimization Tips | 提升查詢效能與資源效率的可操作步驟。 |
SQL Query Explain 進階特性
- 支援 PostgreSQL、MySQL 與 SQLite 執行計畫格式的跨方言支援。
- 完全本地執行，無外部 API 依賴，確保您的 Openclaw Skills 具備最高資料安全性與隱私性。
- 用於歷史紀錄追蹤與團隊協作優化的分級存取權限（Pro/Team）。
- 智慧意圖識別，可區分 DQL (SELECT) 與 DML (INSERT/UPDATE) 操作。
- 連線類型的詳細分解，包括 Hash Join、Nested Loop 與 Merge Join。
SKILL.md
加載中
Openclaw 相關技能
精選*
