← 返回 Skills 市场
sql-explain
作者
shenghoo123-png
· GitHub ↗
· v1.0.0
· MIT-0
96
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install sql-explain-cli
功能描述
解析和优化 PostgreSQL、MySQL、SQLite SQL查询计划,支持SQL生成、格式化及语法检查。
使用说明 (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 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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install sql-explain-cli - 安装完成后,直接呼叫该 Skill 的名称或使用
/sql-explain-cli触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
Initial release
元数据
常见问题
sql-explain 是什么?
解析和优化 PostgreSQL、MySQL、SQLite SQL查询计划,支持SQL生成、格式化及语法检查。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 96 次。
如何安装 sql-explain?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install sql-explain-cli」即可一键安装,无需额外配置。
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