操作场景
管理端负责管理全局 Skill 池，决定用户端可选的 Skill 范围。管理员可自建 Skill、从 SkillHub 导入 Skill，以及启用、禁用和删除 Skill。本文介绍 Skills 管理的完整操作流程。
背景信息
Skill 是 DatabaseClaw 的运维技能插件，每个 Skill 封装一项独立的运维能力（如巡检、慢查询分析等）。管理端的 Skill 池是全局共享的，启用后的 Skill 在用户端创建或编辑实例时可被选用。
Skill 来源分为两类：
自建 Skill：管理员上传自定义的 Skill 包。
SkillHub 导入：从 SkillHub 市场一键导入官方或社区预封装的 Skill。
实现机制
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 版本固定，如需更新需重新导入新版本。
前提条件
已被授予
QcloudDatabaseClawAdminFullAccess CAM 策略。操作步骤
查看 Skills 列表
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 页面以卡片网格形式展示所有 Skill，每张卡片包含 Skill 名称、来源标签、版本号和描述等信息。
支持按来源（全部、SkillHub、自建）和状态（全部状态、启用中、已禁用）进行筛选。
自建 Skill
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 在页面顶部单击自建 Skill，在弹窗中填写以下信息。
参数 | 是否必填 | 说明 |
Skill 名称 | 是 | 技能名称，1 - 128个字符。 |
Skill 描述 | 否 | 技能功能和使用场景说明。 |
Skill 版本 | 是 | 技能版本号。 |
Skill 包 | 是 | 上传 Skill 包文件，支持 .zip / .tar.gz 格式，最大50MB。 |
5. 单击确定完成创建。
新建的 Skill 默认为已禁用状态，开启后用户端可见。
从 SkillHub 导入
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 在页面顶部单击从 SkillHub 导入。
5. 在 SkillHub 弹窗中浏览 Skill 市场，支持按分类（AI 智能、开发工具、效率提升、数据分析、内容创作、安全合规、通讯协作）和关键字搜索。
6. 选择一个或多个目标 Skill，单击导入。
导入后 Skill 将加入当前 Skill 池。导入的 Skill 默认为已禁用状态。
启用/禁用 Skill
启用：单击 Skill 卡片上的开关启用 Skill。启用后用户端创建或编辑实例模板时可选择该 Skill。
禁用：单击 Skill 卡片上的开关禁用 Skill，系统将展示影响范围（被多少实例使用、涉及多少用户），确认后执行禁用。禁用后新创建的模板不可选择该 Skill。
查看 Skill 详情
1. 登录 数据库 AI 服务控制台。
2. 在左侧导航栏选择 DatabaseClaw > 后台管理。
3. 选择能力配置 > Skills 管理页面。
4. 单击目标 Skill 卡片，即可在右侧面板中查看该 Skill 的详细信息。
顶部概览
参数 | 说明 |
Skill 名称 | Skill 的名称。 |
运行状态 | Skill 当前的运行状态，如启用中（绿色标识）。 |
关联信息 | 已关联的用户数、关联的 Claw 实例使用数。 |
创建时间 | Skill 的创建时间，如2026-04-11 22:09:05创建。 |
来源标签 | Skill 来源类型，如自建。 |
版本号 | 当前 Skill 版本，如1.1版本。 |
Skill 信息页签
模块 | 参数 | 说明 |
基本信息 | 技能描述 | Skill 的功能描述文本。 |
调用统计 | 累计调用数 | Skill 自创建以来被调用的总次数。 |
| 近7天调用成功率 | 最近7天内 Skill 调用成功的比例。 |
| 最后调用时间 | Skill 最近一次被调用的时间。 |
操作日志页签
查看该 Skill 的历史操作记录，包括创建、编辑、启用/停用等操作日志。
编辑/删除 Skill
编辑：在 Skill 卡片右下方单击
删除：在 Skill 卡片右下方单击
注意：
仅自建 Skill 支持编辑操作。
删除 Skill 后不可恢复。如仅需临时停用，建议使用禁用功能。
相关操作
管理实例模板
查看运营概览
对应的 API 接口
API 名称 | 说明 |
CreateSkill | 自建 Skill（上传 Skill 包）。 |
DeleteSkill | 删除 Skill。 |
ModifySkill | 修改 Skill 信息。 |
ModifySkillStatus | 修改 Skill 启用/禁用状态。 |
DescribeSkillList | 查询 Skill 目录列表。 |
DescribeSkillDetail | 查询 Skill 详情。 |
DescribeSkillHubCategories | 查询 SkillHub 分类列表。 |
DescribeSkillHubList | 查询 SkillHub 技能列表。 |
DescribeSkillHubDetail | 查询 SkillHub 技能详情。 |
常见问题
禁用 Skill 后已安装该 Skill 的实例会受影响吗？
禁用 Skill 后，已安装该 Skill 的实例仍可继续使用。但新创建的实例将无法选择该 Skill。
SkillHub 中的 Skill 会自动更新吗？
不会。导入后的 Skill 版本固定，如需更新需手动重新从 SkillHub 导入新版本。
