二、背景信息
Skill 是 TencentDB Agent 的运维技能插件，每个 Skill 封装一项独立的运维能力（如巡检、慢查询分析等）。管理端的 Skill 池是全局共享的，启用后的 Skill 在用户端创建或编辑实例时可被选用。
Skill 来源分为三类：
·预置 Skill：系统内置的运维技能，随系统初始化自动导入 Skill 池，默认启用。预置 Skill 分类及说明请参见 预置 Skill 说明。
·自建 Skill：管理员上传自定义的 Skill 包。
·SkillHub 导入：从 SkillHub 市场一键导入或社区预封装的 Skill。
三、实现机制
Skill 的生命周期管理流程如下：
Skill 生命周期包含预置导入、自建上传和 SkillHub 导入三条来源路径：
·预置 Skill：系统初始化时自动导入，默认启用，管理员可按需禁用。
·自建 Skill：管理员上传的 Skill 包经后端解析后存储在 Skill 池中，包含 Skill 元数据（名称、版本、描述）和运行时包。默认禁用，需手动启用后用户端方可使用。
·SkillHub 导入：从 SkillHub 市场拉取 Skill 的元数据和运行时包，复制到本地 Skill 池。默认禁用，需手动启用。
·启用/禁用：修改 Skill 的可见性标记。启用后用户端创建/编辑实例时可在 Skill 选择列表中看到该 Skill；禁用后从选择列表中隐藏，但已安装的实例不受影响。
·删除：执行软删除，标记 Skill 为已删除状态，同时清理关联的运行时包。
四、使用限制
| 限制项 | 限制说明 |
| Skill 名称长度 | 1 – 128字符。 |
| Skill 包格式 | 支持 .zip 和 .tar.gz 格式。 |
| Skill 包大小 | 最大支持导入50MB。 |
| 默认状态 | 新建或导入的 Skill 默认为已禁用状态。 |
五、注意事项
·禁用 Skill 前系统会展示影响范围（被多少实例使用、涉及多少用户），请评估影响后再确认。
·删除 Skill 后不可恢复，如仅需临时停用，建议使用禁用功能。
·从 SkillHub 导入的 Skill 版本固定，如需更新需重新导入新版本。
·预置 Skill 不可删除，仅支持禁用操作。
六、前提条件
已被授予 QcloudDatabaseClawAdminFullAccess CAM 策略。
八、查看 Skills 列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 页面以卡片网格形式展示所有 Skill，每张卡片包含 Skill 名称、来源标签、版本号和描述等信息。
支持按来源（全部、预置、SkillHub、自建）和状态（全部状态、启用中、已禁用）进行筛选。
九、自建 Skill
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 在页面顶部单击自建 Skill，在弹窗中填写以下信息。
| 参数 | 是否必填 | 说明 |
| Skill 名称 | 是 | 技能名称，1 – 128个字符。 |
| Skill 描述 | 否 | 技能功能和使用场景说明。 |
| Skill 版本 | 是 | 版本号，默认为 latest。 |
| Skill 包 | 是 | 上传 Skill 包文件，支持 .zip / .tar.gz 格式，最大50 MB。 |
5. 单击确定完成创建。
新建的 Skill 默认为已禁用状态，开启后用户端可见。
十、从 SkillHub 导入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 在页面顶部单击从 SkillHub 导入。
5. 在 SkillHub 弹窗中浏览 Skill 市场，支持按分类（AI 智能、开发工具、效率提升、数据分析、内容创作、安全合规、通讯协作）和关键字搜索。
6. 选择一个或多个目标 Skill，单击导入。
导入后 Skill 将加入当前 Skill 池。导入的 Skill 默认为已禁用状态。
十一、启用/禁用 Skill
·启用：单击 Skill 卡片上的开关启用 Skill。启用后用户端创建或编辑实例模板时可选择该 Skill。
·禁用：单击 Skill 卡片上的开关禁用 Skill，系统将展示影响范围（被多少实例使用、涉及多少用户），确认后执行禁用。禁用后新创建的模板不可选择该 Skill。
注意：仅 SkillHub 导入和自建 Skill 支持启用/禁用操作。
十二、查看 Skill 详情
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 TencentDB Agent > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 单击目标 Skill 卡片，即可在右侧面板中查看该 Skill 的详细信息。
·顶部概览
| 参数 | 说明 |
| Skill 名称 | Skill 的名称。 |
| 运行状态 | Skill 当前的运行状态，如启用中（绿色标识）。 |
| 关联信息 | 已关联的用户数、关联的 Agent 实例使用数。 |
| 创建时间 | Skill 的创建时间，如2026-04-11 22:09:05创建。 |
| 来源标签 | Skill 来源类型，如自建。 |
| 版本号 | 当前 Skill 版本，如1.0.0版本。 |
·Skill 信息页签
| 参数 | 说明 |
| 描述 | Skill 的功能描述文本。 |
| 创建时间 | Skill 的创建时间。 |
十三、编辑/删除 Skill
·编辑：在 Skill 卡片右下方单击，单击编辑，修改 Skill 的名称、描述或版本，修改完成后，单击确定。
·删除：在 Skill 卡片右下方单击，单击删除，系统将提示该操作不可恢复，展示影响范围后，确认无误后，单击删除。
十四、预置 Skill 说明
TencentDB Agent 提供预置 Skill，覆盖 MySQL（CDB）诊断与巡检、分布式缓存数据库（兼容 Redis）性能分析、DTS 迁移评估等，提供从单实例深度诊断到多实例批量巡检、从迁前画像到启动预检的数据库全生命周期智能运维能力。
预置 Skill 随系统初始化自动导入 Skill 池，默认处于已启用状态，管理员可按需禁用。
十五、MySQL（CDB）诊断类
| Skill 名称 | 功能定位 | 适用场景 | 触发词 |
| cdb-diagnose-tdai | MySQL 智能诊断 | 适用于 MySQL 实例的核心性能瓶颈排查与突发故障诊断，涵盖 CPU 持续高负载、CPU 异常突刺、实例负载异常、QPS 激增并伴随 CPU 飙升、高耗时慢 SQL、主从复制延迟及高可用（HA）切换事件等典型场景。 | CPU 使用率高CPU 打满CPU 突刺CPU 飙升慢 SQL慢查询SQL 很慢主从延迟复制延迟从库延迟RO 延迟HA 切换主从切换主备切换 |
| mysql-alert-inspector | MySQL 智能告警订阅分析 | 支持通过自然语言定义诊断实例范围，自动对接可观测平台（Monitor）与数据库智能管家（DBbrain）双路告警数据，执行告警指标多维汇总与关联统计，并针对 Top N 核心告警实施深度的智能诊断。 | 告警分析告警订阅告警巡检 |
十六、Redis 诊断类
| Skill 名称 | 功能定位 | 适用场景 | 触发词 |
| redis-diagnose-tdai | Redis 智能诊断 | 适用于 Redis 缓存实例的运行状况深度剖析，涵盖 CPU 异常消耗、内存异常增长与容量预警、慢查询及高时延抖动、大 Key/热 Key 专项诊断、以及 Proxy 代理层负载不均等典型异常场景。 | Redis CPU 高Redis CPU 打满Redis CPU 飙升Redis 内存高内存突增内存 OOMRedis 慢查询Redis 高时延P99 突增时延抖动大 Key热 KeyProxy 负载不均Proxy 连接不均衡 |
| redis-alert-inspector | Redis 智能告警订阅分析 | 支持通过自然语言定义诊断实例范围，自动对接可观测平台（Monitor）与分布式缓存数据库（兼容 Redis） 双路告警数据，执行告警指标多维汇总与关联统计，并针对 Top N 核心告警实施深度的智能诊断。 | 告警分析告警订阅告警巡检（Redis） |
十七、TDSQL-C（CynosDB）诊断类
| Skill 名称 | 功能定位 | 适用场景 | 触发词 |
| cynosdb-diagnose-tdai | CynosDB（TDSQL-C）智能诊断 | 适用于 TDSQL-C (CynosDB) 云原生数据库的性能瓶颈诊断与高可用事件分析，涵盖计算节点 CPU 高负载、高耗时慢 SQL 慢查询、存储与计算节点复制延迟、以及高可用（HA）主备切换等核心场景。 | CPU 高CPU 打满CPU 飙升慢 SQL慢查询SQL 很慢主从延迟复制延迟HA 切换主从切换failoverswitchover |
十八、DTS 迁移类
| Skill 名称 | 功能定位 | 适用场景 | 触发词 |
| migration-data-profiling | 云数据库迁移数据画像与时长预估 | 适用于迁移前期的可行性评估与规划：深度分析源端数据库对象分布（涵盖 12 大类），输出结构化迁移决策矩阵（实现可迁移、降级迁移、阻断级限制等策略判定），并智能预测迁移所需的耗时区间。 | 数据画像迁移对象清单哪些能迁哪些不能迁降级建议迁移多久迁移时长预估无主键表 |
| migration-dts-preflight | DTS 数据迁移启动前 17 类前置校验 | 在正式启动迁移任务前，模拟 DTS 预校验控制台流程，全面覆盖 17 类核心检查项，提前精准识别潜在的阻断级（BLOCK）或告警级（WARN）配置风险，并自动生成结构化的修复指引。 | DTS 启动前检查DTS 前置校验DTS 预检任务能否启动preflight准入检查 |
十九、公共 Skill
| Skill 名称 | 功能定位 | 适用场景 |
| cos-uploader | COS 文件上传 | 报告上传 COS 并生成预签名下载链接。 |
20、相关操作
·管理实例模板
·查看运营概览
21、对应的 API 接口
| API 名称 | 说明 |
| CreateSkill | 自建 Skill（上传 Skill 包）。 |
| DeleteSkill | 删除 Skill。 |
| ModifySkill | 修改 Skill 信息。 |
| ModifySkillStatus | 修改 Skill 启用/禁用状态。 |
| DescribeSkillList | 查询 Skill 目录列表。 |
| DescribeSkillDetail | 查询 Skill 详情。 |
| DescribeSkillHubCategories | 查询 SkillHub 分类列表。 |
| DescribeSkillHubList | 查询 SkillHub 技能列表。 |
| DescribeSkillHubDetail | 查询 SkillHub 技能详情。 |
23、Q1：禁用 Skill 后已安装该 Skill 的实例会受影响吗？
禁用 Skill 后，已安装该 Skill 的实例仍可继续使用。但新创建的实例将无法选择该 Skill。
24、Q2：SkillHub 中的 Skill 会自动更新吗？
不会。导入后的 Skill 版本固定，如需更新需手动重新从 SkillHub 导入新版本。