nstung463/kimi-agent-skills/sql-tutor
Claude Code and agent skill by nstung463/kimi-agent-skills
Trust tier 3
- community
Source check pending
Checking that the SKILL.md file is still in the repository.
帮助用户编写和优化 SQL 查询,包括将自然语言转换为 SQL、提供查询优化建议以及解读 EXPLAIN 执行计划。当用户需要 SQL 相关帮助时触发,例如直接请求“自然语言转SQL”、“帮我优化这条SQL”、“解释一下这个执行计划”,或提及关键词如 NL2SQL、SQL优化、慢查询、索引建议、全表扫描、SQL调优,以及支持 SQLite 和 PostgreSQL 数据库时。
Install
npx vskill@latest install nstung463/kimi-agent-skills/sql-tutorSKILL.md
The same SKILL.md was published earlier as serejaris/kimi-skills/sql-tutor.
sql-query-helper
SQL 查询辅助工具 —— 自然语言→SQL 翻译、查询优化分析、EXPLAIN 执行计划解读。
能力概览
| 功能 | 说明 | |
|---|---|---|
| Schema 提取 | 提取数据库表结构(列、类型、索引、外键、样本数据),为 NL→SQL 提供上下文 | |
| 自然语言→SQL | 结合 Schema 上下文,将自然语言描述翻译为 SQL 查询 | |
| 查询优化分析 | 基于 13 条规则检测 SQL 反模式,给出优化建议 | |
| EXPLAIN 解读 | 执行 EXPLAIN 并解读查询计划,识别全表扫描、索引缺失等问题 |
工作流程
自然语言→SQL
- 使用
schema命令提取数据库表结构 - 将 Schema 作为上下文,将用户的自然语言需求翻译为 SQL
- 使用
optimize命令检查生成的 SQL 是否有优化空间 - 使用
explain命令验证查询执行计划
Quick Start
Schema 提取
查询优化分析
EXPLAIN 解读
详细用法
全局参数
| 参数 | 必填 | 默认值 | 说明 | |
|---|---|---|---|---|
--db-type | 否 | sqlite | 数据库类型:sqlite 或 postgres | |
--db-path | schema/explain 时(SQLite) | — | SQLite 数据库文件路径 | |
--dsn | schema/explain 时(PostgreSQL) | — | PostgreSQL 连接串 |
子命令
| 命令 | 需要数据库 | 说明 | |
|---|---|---|---|
schema | 是 | 提取数据库表结构 | |
optimize <sql> | 否 | SQL 查询优化分析(纯规则检测) | |
explain <sql> | 是 | 执行 EXPLAIN 并解读 |
schema 参数
| 参数 | 默认值 | 说明 | |
|---|---|---|---|
--sample-rows, -n | 3 | 每表采样行数(0 表示不采样) | |
--compact | false | 紧凑文本输出(适合嵌入 prompt) |
explain 参数
| 参数 | 默认值 | 说明 | |
|---|---|---|---|
--analyze | false | 使用 EXPLAIN ANALYZE(仅 PostgreSQL,会实际执行查询) |
优化规则清单
optimize 命令检测以下 13 类 SQL 反模式:
| 规则 | 严重度 | 说明 | |
|---|---|---|---|
| avoid-select-star | warning | 避免 SELECT *,显式列出列名 | |
| unbounded-query | info | 缺少 WHERE 和 LIMIT | |
| leading-wildcard-like | warning | LIKE '%...' 导致索引失效 | |
| or-condition | info | OR 条件可能阻止索引使用 | |
| not-in-subquery | warning | NOT IN (子查询) 性能差 | |
| scalar-subquery | warning | SELECT 中的标量子查询逐行执行 | |
| function-on-column | warning | WHERE 中对列使用函数导致索引失效 | |
| implicit-join | info | 隐式连接可读性差 | |
| distinct-usage | info | DISTINCT 可能掩盖 JOIN 问题 | |
| order-without-limit | info | ORDER BY 没有 LIMIT | |
| deep-nesting | warning | 多层嵌套子查询 | |
| having-without-group | warning | HAVING 没有 GROUP BY | |
| not-equal-filter | info | != 条件无法有效使用索引 |
EXPLAIN 解读项
| 检测项 | 适用数据库 | 说明 | |
|---|---|---|---|
| 全表扫描 | SQLite / PostgreSQL | 检测 Seq Scan / SCAN TABLE | |
| 自动临时索引 | SQLite | SQLite 自动创建临时索引,说明缺少永久索引 | |
| 覆盖索引 | SQLite / PostgreSQL | 索引包含所有查询列,无需回表 | |
| 磁盘排序 | PostgreSQL | 排序溢出到磁盘 | |
| 嵌套循环连接 | PostgreSQL | 大表嵌套循环性能差 | |
| 行数估计偏差 | PostgreSQL (ANALYZE) | 预估行数与实际行数差距大于 10 倍 |
输出示例
schema --compact
optimize
explain (SQLite)
安全机制
- 只读连接:SQLite 使用
?mode=ro;PostgreSQL 使用SET SESSION READ ONLY - SQL 白名单:仅允许 SELECT / WITH / EXPLAIN 开头
- 危险关键字拦截:INSERT、UPDATE、DELETE、DROP 等 30+ 关键字被阻止
- 多语句拦截:禁止分号分隔的多条 SQL
- 标识符转义:表名使用双引号转义,防止 SQL 注入
依赖
- Python 3.8+(
sqlite3为内置模块) - PostgreSQL 支持需安装:
pip install psycopg2-binary optimize命令无需数据库连接,零外部依赖
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingskills/sql-tutor/SKILL.md
Popularity
- Repository stars
- 4
- Repository forks
- 1
- 7-day trend score
- 13
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/nstung463/kimi-agent-skills/sql-tutor)