Agent Skills
返回列表
SQL格式化器

SQL格式化器

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 AI 对话框中:

请根据 https://skillhub.cn/install/skillhub.md,安装 @user_af163eaa/z-dev-sql-fmt。

技能介绍

为什么需要这个 SQL 整理工具

面对嵌套多层子查询、多表交叉连接的复杂 SQL,手动调整缩进、拆分长行往往要花十几分钟,稍不留意就会遗漏关键字位置。我们需要快速还原 SQL 结构,让JOIN条件、过滤逻辑一目了然,而不是对着挤成一团的代码行反复翻找。

技能如何帮你整理 SQL

这个技能的核心是粘贴即处理:将冗长 SQL 直接粘贴进来,它会先自动解析语法结构,为SELECT、WHERE、GROUP BY等关键字添加高亮,再用合理的换行和缩进拆分嵌套层级——比如把挤在一行的三表连接拆成带ON条件的分段结构,让子查询缩进逐级递进。同时会扫描潜在性能隐患:比如全表扫描的过滤条件、未加索引的连接字段,用加粗文字提示关注。

整个过程分三步:先理解你对 SQL 的处理需求(如“格式化这段复杂查询”),然后生成可直接复制的格式化结果,标注关键行作用(如-- 此处JOIN关联用户表,过滤非活跃记录);最后补充参数解释和边界陷阱——比如大表连接避免用SELECT *,防止隐式类型转换导致索引失效。

使用时的边界与注意点

它不是专业数据库性能分析工具,提示的“潜在问题”是常见问题点,而非最终诊断结果;生成的格式化代码和性能建议仅供参考,执行前需在测试环境验证。技能不会运行未知脚本,也不会写入任何密钥或凭证,所有操作围绕“结构整理与提示”展开。若需深度优化慢查询,仍需结合数据库EXPLAIN命令或专业工具。

使用场景

  • 接手他人项目时,面对几百行无缩进的复杂SQL,需要快速理清嵌套子查询的逻辑
  • 编写多表关联查询时,SQL语句挤成一团难以阅读,需要格式化后检查JOIN条件
  • 分析慢查询时,想快速识别是否缺少WHERE条件或索引使用不当等性能隐患
  • 在代码审查中,需要统一团队SQL代码风格,确保缩进和关键字格式规范一致

适合人员

  • 后端开发工程师,日常编写复杂SQL查询,需要快速格式化并优化语句结构
  • 数据库管理员,负责审核团队提交的SQL语句,需要识别潜在性能问题和不规范写法
  • 数据分析师,频繁编写多表关联查询,需要确保SQL逻辑清晰且执行高效
  • 刚入职的开发新人,面对遗留系统的SQL代码,需要快速读懂并维护