# 华为云 Skills:让 AI Agent 真正「懂云」的零代码能力插件库

> 604+ 条 CLI 命令封装、61 个即装即用技能、平均 0.2 秒响应、591 个 SDK 文件归零——华为云 Skills 库已经实战验证。

---

## 一、为什么要做「Skills」?

云计算已经进入 **AI Agent 时代**。开发者不再需要逐条记忆 `hcloud VPC ListVpcs --cli-region=cn-north-4` 这类长命令,而是直接用自然语言告诉 AI:

> 「查一下北京四区还有哪些空闲的 ECS 实例」

但问题来了——**AI 模型本身不懂云**。它不知道华为云 API 的调用方式、参数格式、返回值结构。它需要一个「知识+工具」的桥梁。

**华为云 Skills 就是这个桥梁。**

每个 Skill 是一份 Markdown 文档(SKILL.md),清晰定义了:

- 这个 Skill 能做什么(功能描述 + keywords)
- 对应的 hcloud CLI 命令是什么
- 参数如何填写
- 常见问题怎么处理

AI Agent 加载 Skill 后,就能**自主理解用户意图、匹配 Skill、组装命令、执行并返回结果**——整个过程零人工干预。

---

## 二、三层架构:从用户到云 API 的完整链路

```
┌─────────────────────────────────────────┐
│  用户: 「看一下生产环境RDS慢查询」        │
└─────────────────┬───────────────────────┘
                  │ 自然语言
                  ▼
┌─────────────────────────────────────────┐
│  Agent 层(AI Shell)                   │
│  · 意图识别 → 匹配 Skills keywords      │
│  · 加载 SKILL.md → 组装 CLI 命令        │
│  · 执行 → 格式化返回                     │
└─────────────────┬───────────────────────┘
                  │ hcloud CLI 命令
                  ▼
┌─────────────────────────────────────────┐
│  Skill 层(61 个即装即用技能)           │
│  · 一份 SKILL.md = 一个能力             │
│  · 零代码,纯文档驱动                    │
│  · 随 hcloud CLI 自动升级               │
└─────────────────┬───────────────────────┘
                  │ HTTPS API 调用
                  ▼
┌─────────────────────────────────────────┐
│  华为云 API(全球可用区)               │
└─────────────────────────────────────────┘
```

**核心设计哲学:** 纯 CLI 驱动,零代码维护。

对比传统 SDK 方案:

| 维度        | SDK 方案(改造前)                | Skills 方案(改造后)                  |
| --------- | -------------------------- | ------------------------------- |
| 代码量       | 591 个 Python 文件 / 56,402 行 | **0 个文件 / 0 行代码**               |
| 维护方式      | 逐个升级 8 个 SDK 包             | **`hcloud update` 自动同步 + 质量审核** |
| 单次查询耗时    | ~30 秒(含 SDK 初始化)           | **~0.2 秒**                      |
| 新 API 覆盖率 | 需手动扩展代码                    | **CLI 升级即自动同步**                 |
| 学习成本      | 熟悉 SDK 文档 + 编程             | **会写 Markdown 就行**              |

这就是为什么我们能在 **14 个产品分类** 下快速构建 61 个技能,覆盖 AI、计算、存储、网络、容器、安全等核心领域。

---

## 三、能力全景:14 大分类 × 61 个技能 × 6 大场景

### 领域覆盖

| 分类        | 技能数 | 代表技能                                |
| --------- | --- | ----------------------------------- |
| 🧠 人工智能   | 12  | ModelArts 部署管理、MaaS 模型即服务           |
| 💻 计算     | 11  | ECS 实例管理、Flexus 轻量服务器、FunctionGraph |
| 📦 容器与中间件 | 8   | CCE 集群管理、SWR 镜像治理、UCS 多云            |
| 🔧 开发工具   | 7   | CLI 自运维、Terraform 集成、通用工具           |
| 💾 存储     | 5   | OBS 桶管理、EVS 磁盘管理                    |
| 🌐 网络     | 5   | VPC 查询、ELB 实例管理、DNS 记录管理            |
| 📊 大数据    | 4   | RDS 查询、DWS 数据仓库                     |
| 📈 监控运维   | 4   | LTS 日志查询、CES 监控告警                   |
| 🧩 解决方案   | 3   | CSM 云迁移、SAC 云架构                     |
| 🔐 数据安全   | 2   | 数据加密、密钥管理                           |
| ☁ 云数字服务   | 2   | 云盘服务、云备份                            |
| 🛡️ 安全    | 1   | IAM 身份与权限管理                         |

### 六大使用场景

**场景一:资源查询** — 最快 0.13 秒获取任意云资源状态

```
→ 「帮我查一下北京四的 EIP 使用情况」
→ 「列出所有未使用的 EVS 云硬盘」
→ 「这个 VPC 下面有多少台 ECS?」
```

**场景二:运维诊断** — 查看日志、监控、异常一键排查

```
→ 「分析 RDS 生产库过去 24 小时的慢查询」
→ 「查看 LTS 日志中的 ERROR 级异常」
→ 「检查 CCE 集群最近 1 小时的资源水位」
```

**场景三:成本优化** — 预算、计费、资源利用率一键掌控

```
→ 「上个月的账单费用按产品分类汇总」
→ 「找出所有闲置超过 30 天的 EIP」
→ 「有没有可以释放的未绑定云硬盘?」
```

**场景四:安全合规** — IAM 权限、SSL 证书、安全组审计

```
→ 「列出所有用户及其关联的权限策略」
→ 「检查即将过期的 SSL 证书」
→ 「我这安全组有没有开放 22 端口到 0.0.0.0?」
```

**场景五:AI 部署** — ModelArts 训练、推理、资源规划

```
→ 「创建一个 ModelArts Notebook 训练环境」
→ 「部署一个在线推理服务」
→ 「帮我规划训练 GPU 资源」
```

**场景六:CI/CD 集成** — 与流水线自动化打通

```
→ 「推送镜像到 SWR 仓库并部署到 CCE」
→ 「在 CI 脚本中自动创建 ECS 测试环境」
→ 「发布新版本后自动刷新 ELB 后端」
```

---

## 四、如何安装与使用 Skills

华为云 Skills 支持两种安装方式,任选其一即可。

### 方式一:通过 ClawHub CLI 安装

```bash
# 直接安装指定 Skill
npx clawhub install @huaweiclouddev/huawei-cloud-vpc-query
```

安装完成后,在 AI Shell 中直接使用自然语言提问即可。

### 方式二:通过 skills.sh CLI 安装

```bash
# 从华为云 Skills 仓库添加并安装指定 Skill
npx skills add huaweicloud/huaweicloud-skills --skill huawei-cloud-vpc-query
```

运行后,重启 AI Shell 客户端即可使用此 Skill。

### 在对话中使用

安装完成后,直接通过自然语言调用,无需记忆任何命令:

```
你: 「查一下北京四区的 VPC 列表」
AI Shell:加载 vpc-query 技能 → 执行 hcloud VPC ListVpcs
      → 「当前账号在 cn-north-4 下有 3 个 VPC:
         - vpc-default(192.168.0.0/16)
         - vpc-prod(10.0.0.0/8)
         - vpc-dev(172.16.0.0/12)」
```

---

## 五、质量保证:不是「能用」而是「好用」

每个技能上线前都要经过严格的 **四阶段测试**:

1. **安装验证** → 目录结构、配置文件完整性
2. **基础功能** → 每条 CLI 命令现场执行验证
3. **组合兼容** → 多技能协同场景不漏不冲突
4. **方案级 + 幻觉检测** → 避免 AI 编造不存在的能力

**示例标杆:** `huawei-cloud-rds-query` 以 **7/7 满分**通过全部测试,覆盖 46 条 CLI 命令、28 个 API 操作,经 10 轮 70 个问题系统性检验零缺陷。

**不是所有技能都达标:** 评分分布显示,当前平均分为 2.4/7,超过一半的技能正在持续优化中——这正是治理组的工作重心。

---

## 六、运营治理体系:从「建完不管」到「持续运营」

| 维度  | 指标                        |
| --- | ------------------------- |
| 资产层 | 61 个技能 / 14 分类 / 12 域名    |
| 质量层 | 7/7 评分制 · 平均 2.4 · 每月质量报告 |
| 活跃层 | 近 30 天更新 19 个 / 月度活跃度追踪   |
| 运营层 | 4 大类 26 项指标全景看板 + 每周调度    |

完整的技能生命周期覆盖 **8 个阶段**:

```
规划 → 创建 → 测试 → 审核 → 发布 → 运营 → 迭代 → 废弃
```

---

## 七、华为云 Skills 在 Agent 生态中的定位

华为云 Skills 与同领域的其他方案各有侧重:

| 对比维度  | OpenAI GPTs | MCP (Model Context Protocol) | 华为云 Skills            |
| ----- | ----------- | ---------------------------- | --------------------- |
| 定义方式  | GUI 配置      | JSON Schema                  | **Markdown 文档**       |
| 运行环境  | ChatGPT 专属  | 任意 MCP 客户端                   | **AI Shell / 任意 CLI** |
| 云深度   | 浅层集成        | 工具层抽象                        | **60+ API 原生对接**      |
| 代码量   | 0(GUI 配置)   | 需编写 Handler                  | **0(纯文档)**            |
| 版本管理  | 终端不可控       | 开发者自管                        | **hcloud CLI 同步**     |
| 企业级治理 | ❌           | ❌                            | **✅ 4 阶段测试 + 26 项指标** |

**最终结论:** 华为云 Skills 不是另一个 Agent 工具框架——它是**为华为云量身打造的企业级云管理能力体系**。从 CLI 出发、以文档驱动、用 AI 交付,让每一个运维动作都变得可编写、可复现、可自动化。

---

## 八、开始使用

### 对于开发者

```bash
# 1. 配置华为云 AK/SK
hcloud configure

# 2. 安装一个 Skill(二选一)
# 方式一:通过 ClawHub CLI
npx clawhub install @huaweiclouddev/huawei-cloud-vpc-query

# 方式二:通过 skills.sh CLI
npx skills add huaweicloud/huaweicloud-skills --skill huawei-cloud-vpc-query

# 3. 重启 AI Shell 后直接提问
```

### 对于贡献者

想为 Skills 库贡献力量?三步即可:

1. **写一份 SKILL.md**(参照 [官方模板](https://skills.huaweicloud.com/))
2. **本地用 `hcloud` 测试每条命令**
3. **通过 `skill-tester` 四阶段验证后提交** 到 [GitCode 仓库](https://gitcode.com/developer-skill/huaweicloud-skills)

---

## 相关链接

- [华为云 Skills 门户](https://skills.huaweicloud.com/)
- [GitCode Skills 仓库](https://gitcode.com/developer-skill/huaweicloud-skills)
- [hcloud CLI 文档](https://support.huaweicloud.com/cli/)

---


 

Logo

Agent 垂直技术社区,欢迎活跃、内容共建。

更多推荐