把 166 个华为云官方 Agent Skills 一次装好：安装、校验与避坑记录

最近华为云在 GitHub 开源了官方 Agent Skills 集合（huaweicloud/huaweicloud-skills），按产品域整理了 166 个 Skill，覆盖 ECS、OBS、RDS、CCE、VPC 等常用服务。每个 Skill 都是自包含的：一个 SKILL.md 加上 references、scripts、templates，AI Agent 读到它就能按流程调用 hcloud CLI 干活。这篇文章记录我实际安装和校验的过程，给想尝鲜的朋友参考。

一、仓库结构先看清

仓库不是一个 Skill，而是一整套：skills/<产品域>/<服务>/<skill-name>/。16 个产品域里，AI 类最多（32 个），其次是计算（19 个）和开发者工具（19 个）。安装前建议先数一下 SKILL.md 的数量（我用 GitHub API 数过，是 166 个），心里有数才好验收。

二、安装：本质是复制文件

README 给的是 npx skills add 的装法，适合 Claude Code 等 Agent。如果你用的是自定义 Agent 环境，原理相同：把每个 skill-name 文件夹完整复制到你的 skills 目录即可，不需要运行仓库里的任何脚本。注意两点：

1. 文件夹名就是 Skill 的唯一标识，166 个名字互不冲突，可以平铺；

2. 只复制文件，不要顺手执行 Skill 里附带的安装脚本，先看清楚脚本内容再决定。

三、验收：逐文件校验

装完别急着用。我做了两步验收：一是逐文件比对 MD5，源仓库 4848 个文件与本地副本全部一致，0 缺失 0 差异；二是用 Skill 搜索试查了几个关键词（例如 ECS、OBS），确认能被正常索引到。这样后面调用出问题时，可以排除“没装好”这个因素。

四、真正的门槛在凭证

Skill 装好只是第一步。实际调用华为云服务还需要 hcloud（KooCLI）和 AK/SK，并配置好 Region。建议：AK/SK 只给子账号、按最小权限授权，不要用主账号凭证；凭证文件不要提交到任何代码仓库。

五、小结

Agent Skills 这种形态值得关注：它把“怎么操作云服务”的经验沉淀成了 Agent 可执行的操作手册。安装本身十分钟的事，把校验和凭证管理做扎实，后面才是真的省时间。