← Back to Skills Marketplace
shenghoo123-png

sql-explain

by shenghoo123-png · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
96
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install sql-explain-cli
Description
解析和优化 PostgreSQL、MySQL、SQLite SQL查询计划,支持SQL生成、格式化及语法检查。
README (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
Usage Guidance
This skill appears coherent and local-only: it parses/format/explains SQL text and generates SQL from natural language without contacting external services or requesting credentials. A few non-security inconsistencies to be aware of: SKILL.md and README mention optionally using 'sqlean' and commercial tiers (saving history, Pro/Team) — the included code only uses sqlparse and contains no billing or storage logic. If you plan to run it, review the code in sql_explain.py (already small and readable), install the dependency (pip install sqlparse) in an isolated environment, and run the bundled tests (pytest) if you want extra assurance. If you need actual EXPLAIN output from a live database, note this tool only parses text — it will not connect to or run queries against your databases.
Capability Assessment
Purpose & Capability
Name/description (SQL explain/format/check/nl2sql) align with the provided Python modules (sql_explain.py and cli.py). No credentials, binaries, or config paths are requested that would be unrelated to the stated purpose.
Instruction Scope
SKILL.md instructs the agent to parse SQL and EXPLAIN output using sqlparse or sqlean; the shipped implementation uses sqlparse + regex/built-in rules and does not access files, environment variables, or network endpoints. There is no instruction to execute SQL against a live database, only to parse/format/analyze text.
Install Mechanism
No install spec in registry (instruction-only). The code depends on the public Python package sqlparse (README suggests pip install). No remote download/install URLs or archive extraction are present in the package metadata.
Credentials
No required environment variables, secrets, or external credentials are requested. The skill does not reference system credentials or unexpected environment variables.
Persistence & Privilege
always:false and no code attempts to modify other skills or persistent agent-wide settings. The skill is user-invocable and may be invoked autonomously as normal, but it does not request elevated persistence.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install sql-explain-cli
  3. After installation, invoke the skill by name or use /sql-explain-cli
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Slug sql-explain-cli
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is sql-explain?

解析和优化 PostgreSQL、MySQL、SQLite SQL查询计划,支持SQL生成、格式化及语法检查。 It is an AI Agent Skill for Claude Code / OpenClaw, with 96 downloads so far.

How do I install sql-explain?

Run "/install sql-explain-cli" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is sql-explain free?

Yes, sql-explain is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does sql-explain support?

sql-explain is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created sql-explain?

It is built and maintained by shenghoo123-png (@shenghoo123-png); the current version is v1.0.0.

💬 Comments