Agent Skills
返回列表
T2SQL 查询辅导

T2SQL 查询辅导

开发编程 更新于 2026.08.29

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

请根据 https://skillhub.cn/install/skillhub.md 安装 @user_58fad8c3/t2sql-query-tutor 到当前 AI 助手。

技能介绍

解决痛点

非技术同学用中文说清了“想查什么”,却未必知道 JOIN、GROUP BY 会把查询写坏:字段名靠猜、忘记加 LIMIT、口径每次重新对齐,结果不是报错就是慢。团队里还有库存、客户数、销售月报这类已定义指标,如果每轮都从零澄清,很容易出现同一个指标两种算法。这个技能只解决一件事:把一句中文业务需求,变成只读、可复制执行的 SQL,并把容易踩坑的部分显式写出来。

工作方式

流程是“第 0 步语义层命中检查 + 五步生成”。先扫描 references/语义层场景库.md;命中 SC-01 库存、SC-02 客户去重、SC-03 销售月报等场景时,直接采用权威口径,跳过金额口径、去重、订单行数这类重复澄清,并在六项输出后追加第 7 项口径说明。未命中时,再按需求解析、方言确认、字段确认继续推进。

输出固定为六项:SQL 语句、字段说明表、白话版查询逻辑解释、针对本次查询的索引建议、用合理假数据画出的预期结果前 5 行、常见报错预案。默认按 MySQL 方言生成;用户没说条数时补 LIMIT 100。生成后必须用 scripts/check_sql.py 跑禁词、LIMIT、方言、多语句校验,PASS 才交付。

边界与注意点

  • 只处理读查询:不生成 DELETE、UPDATE、DROP、TRUNCATE,也不负责连库执行、ETL 编排、复杂建模或权限管理。
  • 默认 MySQL;SQL Server、BigQuery、Oracle 等非清单方言不支持。Hive、SparkSQL、DuckDB、PG 可通过方言改写支持,必要时跑 check_sql.py --dialect。
  • 禁止猜测列名。字段不确定就列出候选让用户挑;表名或字段与环境不符时提示替换,不硬编。
  • 数据安全优先:宁可多问一句澄清,也不交付可能跑错或越权的 SQL。
  • 没有执行通道时无法实库自纠正;大库多表、生产报表等高准确性场景会按 Prompt 模板给 Schema 链接、多候选或自纠正建议,但应声明“未经实库验证”。

使用场景

  • 数据分析师收到中文查询需求,要把“7月每个客户消费总额从高到低”转成默认 MySQL 的只读 SQL,并给出字段说明。
  • 业务同事贴来一段看不懂的 SQL,希望逐句翻译成白话并标注每个子句作用,不需要连库执行。
  • 数据工程师要把已验证的 MySQL 查询改写为 Hive、SparkSQL、DuckDB 或 PG 方言,并先跑安全校验确认语法差异。
  • 库存、客户数、销售额等已定义指标需按 SC-01、SC-02、SC-03 权威口径输出查询,避免每月重复澄清。

适合人员

  • 需要把中文业务问题转成可执行只读 SQL 的数据分析师或运营,诉求是避免猜测字段、漏加 LIMIT 和重复核对口径。
  • 想把现有 SQL 逐句解释成白话、确认未知子句作用的知识工作者或产品经理。
  • 需要把 MySQL 查询迁移到 Hive、SparkSQL、DuckDB 或 PG 的后端工程师或数据工程师,诉求是获得按方言逐项改造的建议。
  • 负责库存、客户数、销售额等已定义指标口径的数据治理人员或报表负责人,诉求是复用权威口径并说明来源与验收依据。