適用於 Openclaw 的 SQL Generator (Pro)

用於 SQL 生成的 Openclaw Skills 可將自然語言轉化為綱要感知 SQL、優化建議和面向專業團隊的遷移指令碼。

thcjp
v1.0.0
Aug 2, 2026
0
300
0

安裝與下載

1. ClawHub CLI

從來源直接安裝技能的最快方式。

npx clawhub@latest install sql-gen

2. 手動安裝

將技能資料夾複製到以下位置之一

全域模式
~/.openclaw/skills/
工作區
<project>/skills/

優先級:工作區 > 本地 > 內建

3. 提示詞安裝

將此提示詞複製到 OpenClaw 即可自動安裝。

請幫我使用 Clawhub 安裝 sql-gen。如果尚未安裝 Clawhub,請先安裝(npm i -g clawhub)。

想要直接下載?

取得包含原生技能檔案的ZIP壓縮檔。

什麼是 SQL Generator (Pro)?

用於 SQL 生成的 Openclaw Skills 提供了適合團隊、專業級的自然語言轉 SQL 工作流,支援綱要感知、多表 JOIN 生成、效能調優建議、遷移指令碼建立以及版本感知回歸支援。

它專為開發人員、資料工程師、DBA 和自動化管道設計,這些角色和場景需要在真實資料庫綱要中獲得準確的 SQL 輸出,而不僅僅是通用的查詢範本。Openclaw Skills 有助於減少手動撰寫查詢、提高一致性並加速資料庫工作,同時支援結構化輸出和錯誤處理。

SQL Generator (Pro) 應用場景

  • 基於真實綱要上下文,從自然語言提示詞生成 SQL。
  • 構建用於分析和報告的複雜多表 JOIN 查詢。
  • 提供 SQL 效能優化建議,包括索引和重寫建議。
  • 為綱要變更建立 up/down 資料庫遷移指令碼。
  • 為團隊工作流和共享查詢待辦清單批次生成 SQL。
  • 對先前的 SQL 版本執行回歸檢查以保護現有查詢。
  • 在需要結構化資料庫操作時,用於 AI 智能體對話中。
  • 支援基於團隊、企業級的 SQL 自動化,且具有可重複的設定。

SQL Generator (Pro) 運作原理

  1. 連接到資料庫並在啟用時自動讀取綱要中介資料,包括表、欄位、檢視表和索引。
  2. 接收自然語言請求並將其對應到選定的 SQL 生成模式、方言和樣式。
  3. 生成帶有綱要感知欄位選擇、JOIN 邏輯和選擇性優化建議的 SQL。
  4. 可選擇根據綱要變更描述建立遷移指令碼,包括 up 和 down 版本。
  5. 對於批次工作流,處理來自設定檔的提示詞清單,將生成的 SQL 輸出到目錄,並在請求時包含建議。
  6. 執行回歸和計劃檢查,以在部署前比對版本、驗證語法並檢測效能漂移。

SQL Generator (Pro) 設定指南

  1. 確保智能體環境滿足執行要求:
python --version

需要 Python 3.8+。

  1. 安裝與目標資料庫比對的可選資料庫驅動程式:
pip install psycopg2
pip install pymysql
pip install pyodbc
pip install sqlparse
  1. 透過環境變數或設定檔安全地設定資料庫憑證。請勿在原始碼檔案中硬編碼敏感資訊。

  2. 在支援 SKILL.md 工作流的 AI 智能體平台中使用該技能,例如 Claude Code、Cursor、Codex 或 Gemini CLI。

  3. 在應用程式或智能體流中初始化綱要感知生成:

from sql_gen_tool import ProFeatures

pro = ProFeatures(db_url="database:\/\/user:pass@localhost\/mydb")
pro.connect_schema()
  1. 可選擇調整綱要重新整理和批次生成行為:
pro.configure(
    schema_refresh="on-demand",
    include_views=True,
    include_indexes=True,
    dialect="database"
)
  1. 對於團隊工作流,準備提示詞清單檔案和輸出目錄以進行批次生成。

  2. 驗證資料庫中介資料存取權限,特別是適用時的綱要類別讀取(例如 information_schema 或 pg_catalog)。

SQL Generator (Pro) 資料結構與分類體系

該技能圍繞資料庫中介資料、生成請求、SQL 輸出和操作稽核產出物來組織資料。

資料區域 用途 範例
綱要中介資料 為生成提供真實的資料庫上下文 表、欄、型態、檢視表、索引、外鍵
提示詞輸入 擷取自然語言 SQL 請求 內容、模式、樣式
生成的 SQL 儲存產生的查詢或指令碼 SELECT 語句、JOIN 查詢、遷移檔案
建議輸出 返回優化指引 索引建議、重寫提示、EXPLAIN 註釋
版本控制產出物 追蹤跨批次和發行版本的變更 基準快照、差異、回歸結果
錯誤中介資料 支援疑難排解和重試 狀態、錯誤、執行說明

輸入參數:

  • content:主要請求文字
  • mode:選擇性處理模式,例如 JSON、文字或 markdown
  • style:輸出樣式參照

輸出結構通常為 JSON 格式,帶有成功標記、結果負載、中介資料和錯誤欄位。批次工作流還依賴於提示詞檔案(如 YAML),產生的檔案通常使用可預測的命名規範寫入輸出目錄中。

SQL Generator (Pro) 進階特性

  • 透過在生成前讀取即時資料庫結構,實現綱要感知的自動完成。
  • 基於真實欄位和外鍵上下文生成複雜的多表 JOIN 查詢。
  • 效能優化建議,可包括索引推薦和查詢重寫。
  • 遷移指令碼生成,包含用於受控綱要演進的 up/down 版本。
  • 針對團隊範圍內提示詞清單和共享工作流的批次 SQL 生成。
  • 回歸測試支援,用於比對基準和目前 SQL 版本。
  • 版本差異比對,以追蹤跨發行版本的查詢變更。
  • 靈活的綱要重新整理策略,如按需、變更時和排程。
  • 結構化的 JSON 樣式輸出,簡化下游自動化。
  • 專為在跨智能體平台的 Openclaw Skills 工作流中實現安全的、面向團隊的使用而設計。

SKILL.md


加載中

Openclaw 相關技能

METADATA

Github Stars: 0
forks: 0

精選*