技能介绍

要解决什么问题

在 Agent 或本地脚本里查 MySQL，常见痛点是：每次都要拼连接参数、结果格式不统一，以及用户用自然语言描述需求时还要手写 SQL。mysql-query 把「连库 → 执行 → 展示」收成一条路径，并明确支持 SELECT / INSERT / UPDATE / DELETE / CREATE / DROP 等全量 SQL，而不是只做只读查询。

它如何工作

连接配置：首次可将主机、账号、库名等写入 ~/.qclaw/mysql_config.json，之后用 --sql 直接执行，也可用参数临时覆盖连接。
输出格式：默认表格；需要对接下游处理时可选 JSON。
自然语言转 SQL：先理解意图、生成对应 SQL（建议向用户展示 SQL 供确认），再调用 mysql_query.py --sql "..." 执行并返回格式化结果。文档中的对照示例包括 LIMIT、按日期 COUNT、WHERE 条件过滤与带条件的 DELETE。
进阶查询：复杂 JOIN、子查询、聚合与 MySQL 8.0+ 窗口函数等模式可参考技能附带的 references/mysql_examples.md；语法速查见 references/mysql_cheatsheet.md。

适用边界与注意点

该工具 不对 SQL 类型做限制，写操作与 DDL 的风险由使用者承担；对 DROP、无 WHERE 的 DELETE 等破坏性语句，应在执行前与用户确认。常见故障包括未安装 mysql.connector、账号权限、库名错误或连接被拒绝；中文乱码多与 utf8mb4 字符集不一致有关，需在库表与连接层统一配置。