技能 sql-query-builder
🗄️

sql-query-builder

安全

从自然语言生成并优化 SQL 查询

编写复杂 SQL 查询需要深厚的数据库知识,对非专家来说也很耗时。此技能可将自然语言描述转换为经过优化的 SQL 语句,并提供执行计划和性能建议。

支持: Claude Codex Code(CC)
🥈 80 白银
1

下载技能 ZIP

2

在 Claude 中上传

前往 设置 → 功能 → 技能 → 上传技能

3

开启并开始使用

测试它

正在使用“sql-query-builder”。 查找 2024 年第三季度按收入排名前 10 的产品

预期结果:

该技能会返回一个使用 SUM 和 GROUP BY 计算每个产品季度收入的 SQL 查询,并按降序排序。它包含对聚合逻辑的简要说明,并建议在 order_date 列上添加索引以加快筛选速度。

正在使用“sql-query-builder”。 为什么我的客户搜索查询需要 5 秒?

预期结果:

该技能会检查查询结构,并解释 email 列缺少索引导致了全表扫描。它建议创建 B-tree 索引,并重写查询以使用覆盖索引来提升性能。

正在使用“sql-query-builder”。 将此转换为窗口函数查询

预期结果:

该技能会使用 ROW_NUMBER() OVER() 重写原始的自连接查询,以在分区内对记录进行排名。它会比较执行计划,并显示窗口函数方法将复杂度从 O(n squared) 降低到 O(n)。

安全审计

安全
v1 • 5/21/2026

Two high-severity static findings were evaluated and dismissed as false positives. The 'weak cryptographic algorithm' alert at line 4 triggered on Chinese text and UTF-8 symbols in the description field, which contains no cryptography whatsoever. The 'high file entropy' alert is caused by Chinese characters encoded in UTF-8, not binary or encrypted content. The skill consists solely of plain markdown documentation with no executable code, network requests, file system operations, environment variable access, or external command invocations. No malicious intent or security issues were identified.

1
已扫描文件
34
分析行数
0
发现项
1
审计总数
未发现安全问题
审计者: claude

质量评分

55
架构
100
可维护性
87
内容
65
社区
100
安全
83
规范符合性

你能构建什么

快速查询原型设计

数据分析师使用自然语言快速生成用于临时报表和探索的 SQL 查询。

查询性能调优

开发者获得执行计划分析和优化建议,以修复运行缓慢的数据库查询。

SQL 学习助手

学生和初级工程师通过查看自然语言如何映射到结构化查询语言来学习 SQL。

试试这些提示

基础查询生成
编写一个 SQL 查询,查找过去 30 天内注册的所有客户。
连接和筛选
生成一个查询,连接 orders 和 customers 表,以查找 2024 年每位客户的总消费。
执行计划分析
分析为什么这个查询很慢,并建议优化方案:SELECT * FROM large_table WHERE status = 'pending' ORDER BY created_at DESC
复杂聚合
创建一个查询,按产品类别计算月收入,并包含累计总额和百分比增长。

最佳实践

  • 在部署前始终先在非生产环境中审查生成的 SQL
  • 提供清晰的架构详情和表关系,以获得更准确的查询
  • 使用具有代表性的数据量测试优化建议

避免

  • 不要在未经审查的情况下直接在生产数据库上运行生成的查询
  • 避免使用缺少表或列上下文的模糊自然语言提示
  • 跨平台复制查询时,不要忽略数据库特定的语法差异

常见问题

支持哪些数据库系统?
该技能支持标准 SQL 语法以及常见方言,包括 PostgreSQL、MySQL、SQL Server 和 SQLite。
此技能可以对我的数据库执行查询吗?
不能。该技能只生成 SQL 文本。它无法连接到实时数据库,也无法对实时数据库执行查询。
优化建议有多准确?
建议基于通用最佳实践。实际性能取决于你的具体架构、索引和数据分布。
我需要提供数据库架构吗?
提供架构详情可以提高准确性,但该技能也可以基于你描述的常见表结构生成通用查询。
生成的 SQL 能防止注入攻击吗?
该技能会在可能的情况下生成参数化查询模式,但在生产环境中你应始终使用数据库驱动程序的参数绑定。
它能处理复杂的存储过程吗?
该技能专注于 SELECT、INSERT、UPDATE 和 DELETE 语句。复杂的过程式逻辑可能需要手动细化。

开发者详情

文件结构

📄 SKILL.md