← 返回 Skills 市场
sql-explain
作者
shenghoo123-png
· GitHub ↗
· v1.0.0
· MIT-0
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 解析
使用 sqlean 的 explain 模块(或 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 语法错误,提供修正建议。
工作流程
- 识别意图: 判断是解释/生成/格式化/检查
- 解析SQL: 使用 sqlparse 解析语法树
- 执行分析: 对 EXPLAIN 输出进行结构化分析
- 输出结果: 结构化报告 + 优化建议
输出格式
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install sql-explain - 安装完成后,直接呼叫该 Skill 的名称或使用
/sql-explain触发 - 根据 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.
元数据
常见问题
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。
推荐 Skills