alibabacloud-analyticdb-mysql-copilot：阿里云 AnalyticDB for MySQL 运维诊断助手。支持集群信息查询、性能监控、慢查询诊断、运行中SQL分析、表级优化建议等。

慢查询诊断

aliyun adbai describe-chat-message --region cn-beijing --endpoint adbai.cn-beijing.aliyuncs.com --biz-region-id cn-zhangjiakou \

--query "amv-xxx slow query diagnosis for the last 3 hours" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-mysql-copilot

实例健康巡检

aliyun adbai describe-chat-message --region cn-beijing --endpoint adbai.cn-beijing.aliyuncs.com --biz-region-id cn-zhangjiakou \

--query "amv-xxx instance health inspection analysis" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-mysql-copilot

表建模诊断

aliyun adbai describe-chat-message --region cn-beijing --endpoint adbai.cn-beijing.aliyuncs.com --biz-region-id cn-zhangjiakou \

--query "amv-xxx instance space diagnosis and table modeling diagnosis" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-mysql-copilot

数据倾斜检测

aliyun adbai describe-chat-message --region cn-beijing --endpoint adbai.cn-beijing.aliyuncs.com --biz-region-id cn-zhangjiakou \

--query "amv-xxx detect data skewed tables" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-mysql-copilot

产品知识问答

aliyun adbai describe-chat-message --region cn-beijing --endpoint adbai.cn-beijing.aliyuncs.com --biz-region-id cn-beijing \

--query "What is BUILD" --user-agent AlibabaCloud-Agent-Skills/alibabacloud-analyticdb-mysql-copilot

### 4.2 常用参数

**集群管理参数（aliyun adb）**：

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--biz-region-id` | 地域 ID（本 Skill 在 `--db-cluster-id` 存在时要求） | — |
| `--region` | 服务 endpoint 地域（值与 `--biz-region-id` 一致，`aliyun adb` 命令必填） | — |
| `--db-cluster-id` | ADB MySQL 集群 ID（例如 `amv-xxx`） | 必填 |
| `--db-cluster-version` | 集群版本（`3.0`/`5.0`/`All`） | `All` |
| `--page-number` | 页码 | `1` |
| `--page-size` | 每页条数 | `30` |

**智能诊断参数（aliyun adbai）**：

| 参数 | 说明 | 默认值 |
|------|------|--------|
| `--biz-region-id` | 用户集群地域 ID（产品知识问答使用默认值 `cn-beijing`，无需用户确认） | 条件必填 |
| `--query` | 查询内容；实例诊断格式 `"<db-cluster-id> <problem description>"`，知识问答直接提问（支持自然语言时间描述）。 | 必填 |
| `--region` | 服务 endpoint 地域（Skill 根据 `--biz-region-id` 自动映射，无需用户指定） | 自动 |
| `--endpoint` | 服务 endpoint 地址（Skill 根据 `--biz-region-id` 自动映射，无需用户指定） | 自动 |
| `--session-id` | 会话 ID（多轮对话时传入） | 空（新会话） |
| `--timezone` | 时区：例如 `Asia/Shanghai` 等。 | `Asia/Shanghai` |

### 4.3 凭证配置

**阿里云 API 凭证**通过 `aliyun configure` **在本会话之外**配置；CLI 自动读取。

**凭证状态检查**：

aliyun configure list

如果输出中 AccessKeyId 列为空或显示 `<empty>`，则凭证未配置。提示用户：
1. 在**本会话之外**的终端运行 `aliyun configure` 配置
2. 或在 shell profile 中配置环境变量
3. 配置完成后返回并继续

> **🔴 重要规则**：
> - **严禁**引导用户在会话中输入 AK/SK 凭证
> - **严禁**使用 `aliyun configure set --access-key-id` 等显式凭证参数
> - 凭证检查必须是任务第一步；如失败，直接报告并终止

支持多种凭证类型：AK、StsToken、RamRoleArn、EcsRamRole 等。见 [凭证配置文档](https://help.aliyun.com/zh/cli/configure-credentials)。

5. RAM 策略

本 Skill 所需的完整 RAM 权限列表见 references/ram-policies.md。

[必须] 权限失败处理： 当任何命令或 API 调用在执行过程中因权限错误失败时，遵循以下流程：
1. 阅读 references/ram-policies.md 获取本 Skill 所需的完整权限列表
2. 使用 ram-permission-diagnose skill 引导用户申请必要权限
3. 暂停并等待用户确认所需权限已授予

6. 参数确认

重要：参数确认 —— 在执行任何命令或 API 调用之前，所有用户可配置参数（如 biz-region-id、db-cluster-id、--query 等）必须与用户确认。不要在未经用户明确批准的情况下假设或使用默认值。
交互模式强制规则：对于任何需要用户确认或选择的步骤（地域、集群、诊断场景、执行确认等），必须使用选项卡——禁止要求手动输入。具体而言：
- 地域确认 → 选项卡（阅读 references/region-list.md 获取选项，见 1.2 节地域确认规则）——产品知识问答不需要此步骤
- 集群 ID 选择 → 选项卡（从 describe-db-clusters 结果生成）——产品知识问答不需要此步骤
- 诊断场景选择 → 选项卡（用户意图不明确时，列出可用诊断类型）
- 执行前确认 → 选项卡（例如“继续”/“取消”）——产品知识问答不需要此步骤，直接执行

7. 最佳实践

1. CLI 优先：优先使用 CLI 命令进行诊断；集群管理使用 aliyun adb，智能诊断使用 aliyun adbai
2. 命令输出：每次 API 调用必须在响应开头输出完整命令字符串
3. 错误处理：集群 ID 不存在时，引导用户选择正确集群而非直接失败
4. 产品边界：仅处理 ADB MySQL 集群（ID 前缀 am- 或 amv-），不要混用其他产品 API
5. 选项优先：对于任何需要用户确认或选择的步骤，始终使用选项卡；不要要求手动输入

8. 参考链接