火山引擎 RDS MySQL

云上 MySQL 实例创建、参数组与连接串；与「mysql」通用 SQL 技能互补。

v1.0.0 volcengine-skills

作者 / 来源

skillhub

在来源站打开

登录后收藏登录后加入合集

安装方式

CLI 安装（推荐）

claw install shub-volcengine-rds-mysql

需要安装 CLAW CLI

手动下载安装

下载 ZIP 后解压到技能目录即可安装。若在桌面客户端 WebView中直接下载出现异常，本站会改为提示页 + 原始链接，请按页内说明操作。

下载 ZIP (shub-volcengine-rds-mysql-v1.0.0.zip)

触发指令

/volcengine-rds-mysql

跨平台安装指引

该技能声明兼容以下 1 个平台，将 ZIP 解压到对应目录即可被识别。

支持矩阵

Claude Code Coding Agent

macOS / Linux：~/.claude/skills/

Windows：%USERPROFILE%\.claude\skills\

unzip shub-volcengine-rds-mysql-v1.0.0.zip -d ~/.claude/skills/

目录不存在时请先 mkdir -p 创建；启用 Skill 后请重启对应 Agent 让配置生效。

使用指南

火山引擎 RDS MySQL

围绕 火山引擎 RDS MySQL：云上 MySQL 实例创建、参数组与连接串；与「mysql」通用 SQL 技能互补。无需在每次任务前把零散英文说明手工拼进上下文，也减少与客户端默认行为脱节的试错；具体命令、钩子与 JSON 参数仍以 ZIP 包内 SKILL.md 为权威。下文结构与站内 MCP CLI 类专题稿相同：何时用、前置、流程、速查与故障。

何时使用

云上 MySQL 实例创建、参数组与连接串
与「mysql」通用 SQL 技能互补
已获取本技能 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：volcengine-rds-mysql（安装命令以 SKILL.md / claw CLI 为准）。

# 方式 1: 使用 uv (推荐，自动管理依赖)
uv run ./scripts/call_rds_mysql.py [action] [options]

# 方式 2: 使用 python (需要预先安装依赖)
python ./scripts/call_rds_mysql.py [action] [options]

uv run ./scripts/call_rds_mysql.py list-instances

uv run ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx

uv run ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx

uv run ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx

uv run ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx

# 先查询 VPC
uv run ./scripts/call_rds_mysql.py list-vpcs

# 再查询子网
uv run ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a

export VOLCENGINE_ACCESS_KEY="your-access-key"
export VOLCENGINE_SECRET_KEY="your-secret-key"
export VOLCENGINE_REGION="cn-beijing"  # 可选，默认 cn-beijing

站内入库时的触发命令（完整语义见 ZIP）：

# 使用本技能时可在对话中引用或执行上述指令；完整参数与示例见下载包内 SKILL.md。
/volcengine-rds-mysql

最佳实践

先 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 与上游仓库为准，站内稿仅作结构化导读。

## Skill 概览

本 Skill 用于在对话中充当 **火山引擎 RDS MySQL 的智能运维代理**:

- **理解用户的自然语言需求**(中文或英文),识别是否与 RDS MySQL 相关;
- **直接调用内置脚本** `scripts/call_rds_mysql.py` 实时查询 RDS MySQL 并获取结果;
- 当获取到结果或用户粘贴错误信息时,**进一步解释、诊断并给出后续建议**。

**工作模式**:
- 使用 `scripts/call_rds_mysql.py` 脚本直接获取 RDS MySQL 的实时响应

**运行方式**:
脚本支持两种运行方式:
```bash
# 方式 1: 使用 uv (推荐，自动管理依赖)
uv run ./scripts/call_rds_mysql.py [action] [options]

# 方式 2: 使用 python (需要预先安装依赖)
python ./scripts/call_rds_mysql.py [action] [options]
```

## 标准使用流程

1. **确认任务类型与参数**
    - 判断用户意图:查询实例列表、查看实例详情、管理数据库、管理账号、查看参数配置、创建实例等。
    - 收集必要参数(如未指定则使用默认值):
        - `--region`:地域 ID(默认 `cn-beijing`)
        - `--action`:操作类型(如 `list-instances`、`describe-instance`、`list-databases` 等)
        - `--instance-id`:实例 ID(部分操作必需)

2. **构造查询并调用脚本**
   - 示例（以下命令可使用 `uv run` 或 `python` 运行）:
     ```bash
     # 查询实例列表
     uv run ./scripts/call_rds_mysql.py list-instances
     # 或
     python ./scripts/call_rds_mysql.py list-instances

     # 查询指定实例详情
     uv run ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx
     # 或
     python ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx

     # 查询实例的数据库列表
     uv run ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx
     # 或
     python ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx

     # 查询实例的账号列表
     uv run ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx
     # 或
     python ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx

     # 查询实例参数
     uv run ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx
     # 或
     python ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx

     # 查询 VPC 列表（用于创建实例）
     uv run ./scripts/call_rds_mysql.py list-vpcs
     # 或
     python ./scripts/call_rds_mysql.py list-vpcs

     # 查询子网列表
     uv run ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
     # 或
     python ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
     ```

3. **解析结果并后续处理**
    - 将 RDS MySQL 的响应用自然语言解释给用户;
    - 如返回包含敏感操作,评估风险并提醒:
        - 避免在生产环境直接执行高风险操作(如删除实例、删除数据库等);
        - 建议在测试环境验证或做好备份。

## 工具脚本使用说明

### 支持的操作(Actions)

| 操作 | 说明 | 必需参数 |
|------|------|----------|
| `list-instances` | 查询 RDS MySQL 实例列表 | 无 |
| `describe-instance` | 查询指定实例详情 | `--instance-id` |
| `list-databases` | 查询实例的数据库列表 | `--instance-id` |
| `list-accounts` | 查询实例的账号列表 | `--instance-id` |
| `list-parameters` | 查询实例的参数配置 | `--instance-id` |
| `list-parameter-templates` | 查询参数模板列表 | 无 |
| `describe-parameter-template` | 查询参数模板详情 | `--template-id` |
| `list-vpcs` | 查询 VPC 列表 | 无 |
| `list-subnets` | 查询子网列表 | `--vpc-id` |
| `get-price` | 查询实例价格 | 多个配置参数 |

### 命令行参数

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `action` | 操作类型(必需) | - |
| `--region` / `-r` | 火山引擎地域 ID | `cn-beijing` |
| `--instance-id` / `-i` | 实例 ID | 无 |
| `--page-number` | 分页页码 | `1` |
| `--page-size` | 每页记录数 | `10` |
| `--output` / `-o` | 输出格式(json/table) | `json` |

### 输出格式

脚本会将查询信息输出到 `stderr`,将结果输出到 `stdout`,便于分离日志和结果:

```
[操作] list-instances
[地域] cn-beijing
============================================================
[查询结果]
<实际结果内容>
```

## 常见使用场景

### 1. 查看所有实例
```bash
uv run ./scripts/call_rds_mysql.py list-instances
```

### 2. 查看实例详情
```bash
uv run ./scripts/call_rds_mysql.py describe-instance --instance-id mysql-xxx
```

### 3. 查看实例的数据库
```bash
uv run ./scripts/call_rds_mysql.py list-databases --instance-id mysql-xxx
```

### 4. 查看实例的账号
```bash
uv run ./scripts/call_rds_mysql.py list-accounts --instance-id mysql-xxx
```

### 5. 查看实例参数配置
```bash
uv run ./scripts/call_rds_mysql.py list-parameters --instance-id mysql-xxx
```

### 6. 创建实例前查询网络信息
```bash
# 先查询 VPC
uv run ./scripts/call_rds_mysql.py list-vpcs

# 再查询子网
uv run ./scripts/call_rds_mysql.py list-subnets --vpc-id vpc-xxx --zone-id cn-beijing-a
```

## 环境变量配置

1. 获取火山引擎访问凭证：参考 [用户指南](https://www.volcengine.com/docs/6291/65568?lang=zh) 获取 AK/SK

2. 配置以下环境变量:

```bash
export VOLCENGINE_ACCESS_KEY="your-access-key"
export VOLCENGINE_SECRET_KEY="your-secret-key"
export VOLCENGINE_REGION="cn-beijing"  # 可选，默认 cn-beijing
```