安装方式
手动下载安装
下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。
下载 ZIP (shub-mysql-skill-v1.0.0.zip)触发指令
/mysql-skill
跨平台安装指引
该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。
unzip shub-mysql-skill-v1.0.0.zip -d ~/.claude/skills/
目录不存在时请先
mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。
使用指南
MySQL
围绕 MySQL：建表规范、索引优化、事务隔离与备份恢复思路；方言差异注意与 MariaDB 兼容。 无需在每次任务前把零散英文说明手工拼进上下文，也 减少 与客户端默认行为脱节的试错；具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同：何时用、前置、流程、速查与故障。
何时使用
- 建表规范、索引优化、事务隔离与备份恢复思路
- 方言差异注意与 MariaDB 兼容
- 已获取本技能 ZIP，并准备在 Claude Code / OpenClaw 中按 SKILL.md 挂载。
- 希望用中文专题稿快速判断「该不该启用」，再深入英文 SKILL 查参数与边界。
- 需要与团队对齐同一套触发方式、目录约定或回调格式时。
前置条件
- 通用：可运行 Claude Code 或文档要求的客户端；有可读写的项目工作区（或 SKILL.md 指定的沙箱目录）。
- 权威细节：API Key / OAuth、钩子路径、环境变量以 ZIP 内 SKILL.md 为准。
典型流程
- 从 ClawHub / 站内分发获取技能 ZIP，校验版本与校验和（若提供）。
- 阅读 SKILL.md 的安装段落：目录落点、客户端类型（Claude Code / OpenClaw / 脚本）。
- 用文档中的最小示例完成第一次调用（单文件修改、单次查询或单次委派）。
- 确认工作目录、权限边界与输出路径后，再处理多文件或长耗时任务。
- 需要回调 / Webhook / 通知时，按 SKILL.md 配置端点并在测试环境先验通。
与 ZIP / SKILL.md 的关系
站内专题稿与 MCP CLI 类 oss 稿同样：概括何时用、怎么接、怎么排错；命令模板、钩子名、JSON 字段、版本矩阵一律以 ZIP 内 SKILL.md 与 ClawHub 上游为准。
命令示例（摘自包内 SKILL.md）
以下为从上游 SKILL.md（或入库正文）自动抽取的终端/脚本片段；路径、环境变量与参数以当前 ZIP 与官方说明为准。
ClawHub slug：mysql-skill（安装命令以 SKILL.md / claw CLI 为准）。
sudo apt update
sudo apt install mysql-client
brew install mysql-client
export MYSQL_HOST=localhost
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
mysqldump --single-transaction --quick --lock-tables=false \
your_database > backup_$(date +%Y%m%d_%H%M%S).sql
mysqldump your_database table_name > table_backup.sql
mysql your_database < backup_file.sql
mysqldumpslow /var/log/mysql/slow.log
mysqldump --single-transaction --quick your_database > backup_20260323.sql
站内入库时的触发命令（完整语义见 ZIP）：
# 使用本技能时可在对话中引用或执行上述指令；完整参数与示例见下载包内 SKILL.md。
/mysql-skill
最佳实践
- 先 SKILL.md 再猜参数；站内专题稿不替代 schema 与必填字段说明。
- 委派任务时写清验收标准（命令、文件路径、测试命令），减少来回追问。
- 长任务用文档推荐的回调 / 日志落盘代替高频轮询，省 Token 也省机器负载。
- 多技能同时启用时，注意钩子加载顺序与重复工具调用（以 SKILL.md 冲突说明为准）。
调试与排错
- 打开 stderr 与客户端日志；PTY/tmux 场景同时看面板最后几十行输出。
- 参数错误时对照 SKILL.md 中的 JSON/CLI 示例（引号、转义、工作目录）。
- 网络类失败：查代理、防火墙、MCP 传输方式（stdio / HTTP / SSE）。
速查
| 动作 | 说明 |
|------|------|
| 获取技能包 | ClawHub / 站内 ZIP，核对版本 |
| 权威步骤 | 优先阅读 ZIP 内 SKILL.md |
| 首次试跑 | 使用 SKILL.md 最小示例 |
| 验收 | 对照路径、测试命令或回调负载 |
常见故障
- 无输出或立即退出 → 工作目录错误、依赖未装、或 Claude Code 未登录；按 SKILL.md 自检清单执行。
- 权限被拒绝 → 检查沙箱路径、
--permission-mode与工具白名单。 - 与简介不符 → 以英文 SKILL 与上游仓库为准，站内稿仅作结构化导读。
# MySQL Skill - 对话式数据库管理
通过自然语言，轻松管理 MySQL 数据库，无需手写 SQL！
---
## 🎯 功能特点
### 核心能力
- **🔍 智能查询** - 用自然语言描述需求，自动生成 SQL
- **📊 数据分析** - 快速统计、聚合、分组查询
- **🛠️ 表管理** - 建表、修改表结构、索引管理
- **💾 备份恢复** - 数据库/表级备份和恢复
- **🔧 优化建议** - 慢查询分析、索引优化建议
---
## 📋 使用场景
### 查询场景
- "查询昨天注册的用户"
- "统计每个部门的员工数量"
- "找出销售额前十的产品"
- "查询最近一周的订单，按时间倒序"
### 数据操作
- "给用户表中添加一个 phone 字段"
- "把所有状态为 pending 的订单改为 confirmed"
- "删除三个月前的日志记录"
### 备份场景
- "备份数据库"
- "恢复昨天下午的备份"
- "导出用户表的数据"
---
## 🔧 前置条件
### 1. 安装 MySQL 客户端
**Ubuntu/Debian:**
```bash
sudo apt update
sudo apt install mysql-client
```
**macOS:**
```bash
brew install mysql-client
```
**Windows:**
下载并安装 MySQL 官方客户端工具
### 2. 配置数据库连接
创建配置文件 `~/.my.cnf`:
```ini
[client]
host = localhost
user = your_username
password = your_password
database = your_database
```
或通过环境变量：
```bash
export MYSQL_HOST=localhost
export MYSQL_USER=your_username
export MYSQL_PASSWORD=your_password
export MYSQL_DATABASE=your_database
```
---
## 💻 常用操作
### 查询数据
**自然语言描述：**
```
查询销量最高的 5 个产品
```
**AI 生成的 SQL：**
```sql
SELECT product_name, SUM(quantity) as total_sales
FROM orders
GROUP BY product_name
ORDER BY total_sales DESC
LIMIT 5;
```
---
### 创建表
**自然语言描述：**
```
创建一个用户表，包含 id、用户名、邮箱、注册时间
```
**AI 生成的 SQL：**
```sql
CREATE TABLE users (
id INT AUTO_INCREMENT PRIMARY KEY,
username VARCHAR(50) NOT NULL,
email VARCHAR(100) NOT NULL UNIQUE,
created_at TIMESTAMP DEFAULT CURRENT_TIMESTAMP,
INDEX idx_username (username)
);
```
---
### 数据备份
**备份数据库：**
```bash
mysqldump --single-transaction --quick --lock-tables=false \
your_database > backup_$(date +%Y%m%d_%H%M%S).sql
```
**备份单个表：**
```bash
mysqldump your_database table_name > table_backup.sql
```
**恢复数据：**
```bash
mysql your_database < backup_file.sql
```
---
## 🔍 高级功能
### 慢查询分析
1. **开启慢查询日志：**
```sql
SET GLOBAL slow_query_log = 'ON';
SET GLOBAL long_query_time = 2;
SET GLOBAL slow_query_log_file = '/var/log/mysql/slow.log';
```
2. **分析慢查询：**
```bash
mysqldumpslow /var/log/mysql/slow.log
```
### 索引优化建议
查看表的索引使用情况：
```sql
SELECT
TABLE_NAME, INDEX_NAME, CARDINALITY
FROM information_schema.STATISTICS
WHERE TABLE_SCHEMA = 'your_database'
ORDER BY TABLE_NAME, INDEX_NAME;
```
### 数据库性能检查
查看数据库状态：
```sql
SHOW STATUS LIKE 'Threads_connected';
SHOW STATUS LIKE 'Questions';
SHOW STATUS LIKE 'Uptime';
```
---
## ⚠️ 注意事项
### 安全建议
1. **使用环境变量存储密码**，不要在命令行中明文显示
2. **最小权限原则** - 使用只读用户进行查询操作
3. **生产环境谨慎操作** - 写操作前先备份数据
4. `**LIMIT 子句** - 大数据量查询一定要加 LIMIT
### 性能优化
1. 为常用查询字段添加索引
2. 避免 `SELECT *`，只查询需要的字段
3. 大量数据操作使用事务
4. 定期清理过期数据
---
## 🎓 示例对话
### 示例 1：查询分析
**用户：** "帮我看看这个月的销售额分布"
**AI：** "好的，我来查询这个月每天的销售额。"
```sql
SELECT
DATE(order_date) as date,
SUM(amount) as daily_sales
FROM orders
WHERE order_date >= DATE_FORMAT(NOW(), '%Y-%m-01')
GROUP BY DATE(order_date)
ORDER BY date;
```
### 示例 2：表结构修改
**用户：** "给订单表加一个优惠券字段"
**AI：** "好的，正在添加字段..."
```sql
ALTER TABLE orders
ADD COLUMN coupon_code VARCHAR(50) NULL
AFTER discount_amount;
```
### 示例 3：数据备份
**用户：** "备份一下数据库"
**AI：** "正在备份数据库到 backup_20260323.sql..."
```bash
mysqldump --single-transaction --quick your_database > backup_20260323.sql
```
---
## 🛠️ 故障排查
### 常见错误
**1. ERROR 1045 (28000): Access denied**
- 检查用户名和密码
- 确认用户有权限访问该数据库
**2. ERROR 2002 (HY000): Can't connect to MySQL server**
- 检查 MySQL 服务是否运行
- 确认主机名和端口配置正确
**3. Query took too long**
- 检查是否添加了合适的索引
- 使用 `EXPLAIN` 分析查询计划
- 考虑添加 LIMIT 限制结果数量
---
## 📚 参考资料
- [MySQL 官方文档](https://dev.mysql.com/doc/)
- [MySQL 性能优化指南](https://dev.mysql.com/doc/refman/8.0/en/optimization.html)
- [MySQL Workbench](https://www.mysql.com/products/workbench/)
---
**开始使用：** 直接告诉我你想查询什么，我会自动生成 SQL！🚀