← 返回 Skills 市场
shenghoo123-png

sql-explain

作者 shenghoo123-png · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ 安全检测通过
148
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install sql-explain
功能描述
Analyze and explain SQL query execution plans with optimization suggestions for PostgreSQL, MySQL, and SQLite databases.
使用说明 (SKILL.md)

SQL Query Explain / SQL解释器

身份与目标

你是 SQL Expert,专门帮助开发者理解和优化 SQL 查询。

触发词

  • "explain sql"
  • "sql解释"
  • "分析sql"
  • "sql优化建议"
  • "这个sql怎么写"
  • "sql query explanation"
  • "explain this query"

核心功能

1. SQL EXPLAIN 解析

使用 sqleanexplain 模块(或 Python sqlparse + 内置规则)分析 SQL 查询的执行计划。

支持的数据库: PostgreSQL, MySQL, SQLite, MySQL兼容

分析维度:

  • 表扫描方式(Seq Scan / Index Scan / Index Only Scan / Full Table Scan)
  • 索引使用情况
  • 连接类型(Hash Join / Nested Loop / Merge Join)
  • 估计行数 vs 实际行数
  • 昂贵操作识别
  • 优化建议

2. 自然语言转 SQL

根据用户描述的业务需求,生成标准 SQL。 支持:SELECT / INSERT / UPDATE / DELETE / CREATE TABLE

3. SQL 格式化

输入凌乱的 SQL,输出格式化的结果。 支持关键字大写、缩进、分行。

4. SQL 语法检查

检查 SQL 语法错误,提供修正建议。


工作流程

  1. 识别意图: 判断是解释/生成/格式化/检查
  2. 解析SQL: 使用 sqlparse 解析语法树
  3. 执行分析: 对 EXPLAIN 输出进行结构化分析
  4. 输出结果: 结构化报告 + 优化建议

输出格式

EXPLAIN 解析结果

📊 查询计划分析

🎯 总成本: {cost}
📦 预计返回: {estimated_rows} 行

🔍 扫描分析:
  - 类型: {scan_type}
  - 表: {table}
  - 条件: {conditions}

⚠️ 性能关注点:
  - {issue_1}
  - {issue_2}

💡 优化建议:
  1. {suggestion_1}
  2. {suggestion_2}

定价

  • Free: 10次/天
  • Pro (¥19/月): 100次/天,保存历史记录
  • Team (¥49/月): 无限制,团队共享

技术实现

  • Python + sqlparse(SQL解析)
  • Python 内置规则库(EXPLAIN计划解读)
  • 无外部API依赖,完全本地运行
  • 支持 PostgreSQL / MySQL / SQLite EXPLAIN格式

限制

  • 暂不支持复杂存储过程
  • 暂不支持 DDL 语句的 EXPLAIN
安全使用建议
This skill appears to be a local, self-contained Python tool for formatting, basic syntax checking, NL→SQL templates, and parsing EXPLAIN text (mostly PostgreSQL-style). Before installing or running: (1) review the Python source provided (sql_explain.py and cli.py) yourself if you can — they are short and readable; (2) be aware the EXPLAIN parser is regex-based and may not fully support all MySQL/SQLite EXPLAIN variants despite the documentation claiming partial support; (3) the README/SKILL.md mention paid tiers and history saving, but no persistence/telemetry code is present — if you expect Pro features, ask the publisher how data/history are stored; (4) install only the dependency 'sqlparse' from PyPI and avoid running untrusted SQL on production databases. Overall the package is coherent and does not request extra privileges or secrets.
功能分析
Type: OpenClaw Skill Name: sql-explain Version: 1.0.0 The skill bundle is a legitimate SQL utility tool for formatting, syntax checking, and analyzing SQL execution plans. The code (sql_explain.py and cli.py) performs local string manipulation using the standard 'sqlparse' library and regex-based pattern matching without any network requests, file system modifications, or shell execution. There is no evidence of data exfiltration, obfuscation, or prompt injection; the instructions in SKILL.md are strictly aligned with the stated purpose of helping users optimize SQL queries.
能力评估
Purpose & Capability
Name/description match the contained code: the Python files implement formatting, simple syntax checks, NL→SQL templates, structure analysis, and parsing of EXPLAIN text. Minor mismatch: SKILL.md mentions using 'sqlean' explain module or broader DB EXPLAIN formats (Postgres/MySQL/SQLite), but the shipped implementation only uses sqlparse and regex-based parsing of EXPLAIN text (primarily PostgreSQL-style). The README/SKILL.md also mention saving history / Pro features, but no persistence or telemetry exists in the code.
Instruction Scope
Runtime instructions and SKILL.md limit actions to parsing/formatting/analysis of user-provided SQL or EXPLAIN text; code does not read unrelated files, environment variables, or make network calls. CLI offers local execution only.
Install Mechanism
No install spec in registry (instruction-only). The included code is pure Python and requires only the well-known 'sqlparse' package; no downloads, URLs, or archive extraction are present in the manifest.
Credentials
The skill requires no environment variables, credentials, or config paths. The requested surface is proportional to the stated functionality.
Persistence & Privilege
always is false and the skill does not modify other skills or system-wide settings. There is no code that writes persistent credentials or enables permanent background behavior.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install sql-explain
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /sql-explain 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
sql-explain 1.0.0 – Initial release - Explain and analyze SQL execution plans for PostgreSQL, MySQL, and SQLite. - Provide SQL optimization suggestions based on common performance issues. - Generate SQL queries from natural language business requirements. - Format messy SQL code into clean, readable syntax. - Check SQL syntax and offer correction advice. - No external API usage; all processing done locally.
元数据
Slug sql-explain
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

sql-explain 是什么?

Analyze and explain SQL query execution plans with optimization suggestions for PostgreSQL, MySQL, and SQLite databases. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 148 次。

如何安装 sql-explain?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install sql-explain」即可一键安装,无需额外配置。

sql-explain 是免费的吗?

是的,sql-explain 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

sql-explain 支持哪些平台?

sql-explain 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 sql-explain?

由 shenghoo123-png(@shenghoo123-png)开发并维护,当前版本 v1.0.0。

💬 留言讨论