前言¶

日常工作中，开发者经常需要写 SQL 查询数据、统计指标或分析报表。面对复杂的业务问题，从零构建 SQL 不仅耗时，还容易出错。一种常见的做法是先问业务人员要查询条件，再手动拼 SQL，或者依赖现成的 BI 工具，但在 CLI 环境或需要频繁调用的场景下，这些方案并不够直接。

下面介绍 bi-query，它可以将自然语言问题直接转换为 SQL 查询，并返回结果解读，省去手动写 SQL 的步骤。

是什么¶

bi-query 是一个基于 Text-to-SQL 的 Skill，连接 MySQL 数据库，将自然语言问题转换为 SQL 查询并返回智能解读。当用户问及数据库中的数据、报表、统计、业务指标、记录查询等问题时触发。它由社区用户 user_4203c0d6 发布，版本为 1.0.0，当前在 SkillHub 上的评分为 100000，已有 627 次下载。

核心功能¶

• 连接 MySQL 数据库
• 将自然语言问题转换为 SQL 查询
• 执行 SQL 并返回查询结果
• 对查询结果进行智能解读

安装与启用¶

在支持 SkillHub 的客户端中，可以通过以下命令安装：

skill install @user_4203c0d6/bi-query

安装完成后，Skill 即可启用。该 Skill 不需要 API 密钥（requires_api_key=false）。

典型用法¶

在使用时，可以直接向 AI 提问数据库相关的问题。例如：

• “查询最近一周的订单数量”
• “统计各部门的业务指标”
• “找出排名前 10 的用户”

AI 会将自然语言转换为 SQL 查询并返回结果。根据官方提供的关键词，该 Skill 适用于以下场景：
- 查数据、问数据
- 数据库查询、SQL
- 报表、统计
- 业务指标
- 多少、哪个、排名、趋势

适用场景与注意¶

bi-query 适合需要频繁查询数据库、生成统计报表或分析业务指标的场景。使用时需要注意：
- 需要提供有效的 MySQL 数据库连接
- 查询权限和安全性由使用者自行负责
- 适合结构化数据的查询，对复杂查询可能需要调整问题表述

短结尾¶

bi-query 通过自然语言直接生成 SQL 查询，简化了从问题到数据的过程。官方地址：https://api.skillhub.cn/user_4203c0d6/bi-query