华为云 Skills 库 —— 让 AI 自然语言操控云基础设施

# 华为云 Skills 库 —— 让 AI 自然语言操控云基础设施

> **让每一句自然语言在云上找到执行路径。**

---

## 一、什么是华为云 Skills 库?

**华为云 Skills 库**([skills.huaweicloud.com](https://skills.huaweicloud.com/))是一个面向 AI Agent 的**云技能市场**,提供 60 个可直接安装的 Agent Skill,覆盖计算、网络、存储、容器、AI、安全、计费等全产品域。

每个 Skill 本质上是一份 **Markdown 文档**——它告诉 AI Agent 如何理解用户的自然语言指令、如何调用华为云 CLI(hcloud / KooCLI)执行操作、如何处理结果并安全返回。

> **关键词:Skill = 自然语言 → 云操作的翻译器。**

---

## 二、核心功能一览

### 2.1 一站式 Skill 市场

| 功能 | 描述 |
| ------------ | ---------------------------------- |
| **浏览分类** | 按产品域浏览:计算、网络、存储、容器、AI、安全、大数据、开发工具等 |
| **全文搜索** | 搜索 Skills 名称/描述/标签,快速定位所需能力 |
| **Skill 详情** | 查看完整功能说明、使用场景、CLI 命令模板 |
| **一键安装** | 复制 CLI 安装命令,直接集成到 AI Shell |
| **版本管理** | 每个 Skill 标注版本号,支持升级 |

### 2.2 Skill 核心要素

每个 Skill 包含:

```yaml
name: huawei-cloud-billing-scout # 唯一名称
version: 1.0.0 # 语义化版本
description: | # 功能描述 + 触发条件
Huawei Cloud BSS billing query...
tags: [huawei-cloud, billing, finops] # 标签分类
```

- **触发词**:定义哪些用户输入会激活该 Skill(如 "余额"、"账单"、"对账"、"代金券")
- **前置条件**:CLI 版本要求、IAM 权限要求
- **操作流程**:Step-by-step 的执行指令
- **安全规则**:只读/只写策略、屏蔽危险操作

### 2.3 当前覆盖范围(60 Skills)

| 产品域 | 数量 | 代表性 Skill |
| ---------- | --- | -------------------------------------------------- |
| **AI** | 12 | Ascend 模型部署/算子优化、ModelArts 模型适配/分析、GES 图查询 |
| **计算** | 10 | ECS 无密码登录、Flexus L 实例管理/运维/部署、FunctionGraph 创建/触发器 |
| **容器** | 8 | CCE 集群管理、SWR 镜像治理/自动化/企业实例、CCI 实例管理、UCS 策略/集群接入 |
| **存储** | 5 | OBS 桶创建/上传/统计/网站托管、通用存储查询 |
| **网络** | 2 | EIP 成本优化、通用网络查询 |
| **监控** | 3 | CES ECS 监控、ECS 告警查询、通用监控查询 |
| **计费** | 2 | 账单查询、商务支持查询 |
| **安全** | 1 | IAM 身份与权限查询 |
| **大数据** | 4 | DWS SQL 检查/CPU 诊断/IO 诊断/内存诊断 |
| **开发工具** | 6 | Skill 创建器/发现器、CLI 指导、Terraform 生成/安装、CodeArts 代码生成 |
| **解决方案** | 3 | SAC YOLO/New API 部署、CCE 环境评估 |
| **ICP 备案** | 2 | ICP 备案咨询、ICP 规则咨询 |
| **综合** | 2 | 通用计算查询、视频点播采集 |

---

## 三、架构设计

### 3.1 双端协作

```
┌──────────────────────────────┐ ┌───────────────────────────────┐
│ AI Shell │ │ 华为云 Skills 门户 │
│ (Hermes Agent / 其他) │ │ │
│ │ │ ┌─────────────────────┐ │
│ ┌──────┐ ┌──────┐ │ │ │ 分类浏览 & 搜索 │ │
│ │ 用户 │→ │Agent │──skill──→│ │ │ │ │
│ │ 输入 │ │ 推理 │ │ │ │ Skill 详情 & 版本 │ │
│ └──────┘ └──┬───┘ │ │ └─────────────────────┘ │
│ │ │ │ │
│ ┌──────▼──────┐ │ │ ┌─────────────────────┐ │
│ │ Skill 文档 │ │ │ │ 一键安装 CLI 命令 │ │
│ │ (SKILL.md) │──hcloud─→│ │ │ │
│ │ 指令 + 规 │ │ │ │ 用户反馈 & 评价 │ │
│ │ 则 + 安全 │ │ │ └─────────────────────┘ │
│ └─────────────┘ │ │ │
│ │ │ │ 后端: Vue 3 SPA │
│ ┌──────▼──────┐ │ │ 数据源: GitCode 仓库 │
│ │ 华为云 CLI │ │ │ │
│ │ (hcloud) │──API──→│ │ │
│ │ 执行操作 │ │ │ 华为云 OpenAPI │
│ └─────────────┘ │ │ │
└──────────────────────────────┘ └───────────────────────────────┘
```

### 3.2 Skill 文档格式

Skill 本质是**结构化的 Markdown**,包含三个关键层次:

```
┌───────────── Frontmatter ─────────────┐
│ name / version / description / tags │ ← 元数据,供搜索和匹配
└────────────────────────────────────────┘
┌────────── 执行规则层 ──────────────────┐
│ • 前置条件检查 │
│ • 触发词 & 路由条件 │ ← AI 推理时的决策依据
│ • 安全边界声明 │
└────────────────────────────────────────┘
┌────────── 操作指令层 ──────────────────┐
│ • Step-by-step 执行流程 │
│ • CLI 命令模板 & 参数说明 │ ← 具体执行动作
│ • 结果解析 & 错误处理 │
│ • 跨 Skill 组合指南 │
└────────────────────────────────────────┘
```

### 3.3 安全架构

- **只读 Skill**:查询类(IAM/VPC/存储/监控)严格限制写操作
- **写操作 Skill**:要求用户二次确认(Flexus L 创建、DNS 增删等)
- **凭证隔离**:AK/SK 加密存储于 `~/.hcloud/config.json`,不在对话中暴露
- **IAM 最小权限**:每个 Skill 声明所需 IAM 策略

---

## 四、应用场景

### 4.1 场景一:账单对账与成本分析

```bash
用户:帮我看看这个月的账单,有没有异常消费

Agent 行为:
1. 加载 huawei-cloud-billing-scout Skill
2. 查询月度消费汇总 → 获取总金额和分类明细
3. 对比上个月数据,标记涨幅 > 20% 的产品线
4. 列出代金券抵扣情况
5. 返回账单简报(总金额 + 分类占比 + 异常标记)
```

### 4.2 场景二:IAM 权限审计

```bash
用户:检查当前账号下有谁启用了编程访问密钥

Agent 行为:
1. 加载 huawei-cloud-iam-query Skill
2. 查询所有 IAM 用户列表
3. 筛选已启用 AK/SK 的用户
4. 检查 MFA 设备绑定状态
5. 返回安全合规报告
```

### 4.3 场景三:容器镜像治理

```bash
用户:清理 SWR 仓库中所有 3 个月未使用的镜像

Agent 行为:
1. 加载 huawei-cloud-swr-image-governance Skill
2. 列出 SWR 仓库所有镜像
3. 按更新时间筛选 > 90 天的镜像
4. 生成清理清单,要求用户确认
5. 用户确认后逐批删除
```

---

## 五、在 AI Shell 中使用

华为云 Skills 库无缝集成 **Hermes Agent**(或其他支持 Skill 机制的 AI Shell)。

### 5.1 安装流程

```bash
# 1. 从门户复制安装命令
hermes install huawei-cloud-billing-scout

# 2. 确认安装
hermes skills list | grep huawei-cloud

# 3. 验证 CLI 配置
hcloud version
hcloud configure list
```

### 5.2 使用方式

安装后,直接用自然语言与 AI Agent 对话,Agent 自动匹配并加载相关 Skill:

```bash
# 账单查询 —— 自动加载 billing-scout Skill
用户:这个月的消费是多少?

# IAM 查询 —— 自动加载 iam-query Skill
用户:检查哪些用户有 administrator 权限

# 容器管理 —— 自动加载 cce-cluster-management Skill
用户:列出所有 CCE 集群及其节点状态

# 存储管理 —— 自动加载 storage-query Skill
用户:查询所有 OBS 桶的存储用量
```

### 5.3 交互示例(真实对话)

```
用户 ▶ 我想买一台 Flexus L 实例,2核4G,装 Ubuntu 22.04

Agent 思考 ▶
↓ 加载 huawei-cloud-flexus-l-server-manage Skill
↓ 查询可用区域 / 镜像 / 规格
↓ 生成创建方案

Agent 回答 ▶
已查到可用配置:
• 区域:cn-north-4a
• 规格:flexus.l.xlarge(2核4G)
• 镜像:Ubuntu 22.04 LTS
• 预估月费:¥98.50

⚠️ 创建实例会按配置扣费,是否确认创建?
```

### 5.4 AI Shell 的 Skill 发现机制

```
用户输入


文本匹配 ──── 精确触发词匹配 ────→ 直接加载对应 Skill

└─→ 语义相似度匹配 ───→ 加载最匹配的 Skill

└─→ 组合场景检测 ───→ 多 Skill 协作执行
```

### 5.5 从 AI Shell 发现 Skills

无需离开终端,在 AI Shell 中直接用自然语言搜索、发现和安装 Skills:

```bash
# 方式一:自然语言搜索(自动匹配 huawei-cloud-find-skills)
用户:华为云有哪些 Skill 可以用?

Agent 行为:
→ 加载 huawei-cloud-find-skills Skill
→ 展示全部分类列表(计算/网络/存储/容器/AI 等)
→ 支持进一步筛选:"我想看看存储相关的"

# 方式二:查询已安装的 Skill
用户:我装过哪些华为云的 Skill?

# 方式三:直接对话式安装
用户:帮我安装 IAM 查询的 Skill
→ hermes install huawei-cloud-iam-query

# 方式四:Skill 内发现(安装后自动路由)
用户:查一下这个月的消费
→ 自动匹配 billing-scout Skill,无需手动切换
```

这种"发现 → 安装 → 使用"全在 AI Shell 内闭环的体验,让用户无需频繁切换浏览器和终端。

---

## 六、典型用户画像

| 角色 | 使用场景 |
| --------- | ------------------- |
| **运维工程师** | 日常巡检、账单对账、安全审计、成本分析 |
| **开发工程师** | 部署测试环境、查询容器/日志、管理镜像 |
| **架构师** | 环境评估、架构验证、资源规划 |
| **入门用户** | 购买服务器、查询存储、探索云服务 |

---

## 七、快速上手

```bash
# Step 1: 访问华为云 Skills 门户
> https://skills.huaweicloud.com/

# Step 2: 浏览或搜索所需 Skill
# Step 3: 复制 CLI 安装命令
hermes install huawei-cloud-billing-scout
hermes install huawei-cloud-iam-query
hermes install huawei-cloud-flexus-l-server-manage

# Step 4: 开始使用
# "这个月的账单是多少?"
# "检查 IAM 用户权限"
# "购买一台 Flexus L 实例"
```

---

> **华为云 Skills 库 —— 让 AI 从"回答问题"进阶为"完成任务"。**
>
> 从一条 DNS 记录到一套完整的高可用架构,从一句自然语言到一次云上操作,
> 华为云 Skills 库正在重新定义人与云的交互方式。

---

*立即体验:[skills.huaweicloud.com](https://skills.huaweicloud.com/)*