Skill 使用技巧

一、什么是 Skill

Skill 是封装了特定领域能力的可复用指令包。每个 skill 包含一个 SKILL.md（描述触发条件和使用方法）以及配套的脚本、参考资料。Agent 会根据你的自然语言请求，自动匹配并加载合适的 skill。

核心价值：

• 不用记命令，说人话就能触发
• 封装了正确的调用方式、鉴权和错误处理
• 可跨会话复用，可分享给他人安装

二、发现 Skill 的三种方式

1. 直接查看已安装列表

已安装的 skill 会在每轮对话的 Available Skills 区域列出，包含 name、description 和 tags。养成习惯先扫一眼这个列表。

2. 用 find-skills 搜索

当你不确定有没有某个 skill 时，调用 huawei-cloud-find-skills：

帮我找一下有没有管理 RDS 的 skill

它会同时搜索已安装和可安装目录两个来源，返回匹配结果。

3. 关键词匹配技巧

匹配是按 动作动词 + 对象名词 来排名的，不是只看名词。举例：

技巧： 请求里尽量同时包含「做什么」和「对谁做」，匹配准确率会大幅提升。

三、加载与执行

加载方式

Agent 通过 load_skill 工具加载 skill 的完整指令。你不需要手动操作，只需用自然语言描述需求即可。

执行流程

你的请求 → Agent 匹配 skill → load_skill 加载指令 → 按指令执行 → 返回结果

技巧：一次说清上下文

加载 skill 后，Agent 需要具体参数才能执行。一次性提供关键信息可以减少来回确认：

❌ 效率低：

帮我查一下 ECS

✅ 效率高：

帮我查一下 cn-north-4 区域，VPC-xxxxx 下的 ECS 实例列表

四、Skill 优先级链

当多个 skill 可能匹配时，按以下优先级选择：

1. 已安装且精确匹配 → 直接使用
2. 目录中唯一匹配 → 自动安装并使用
3. 多个匹配 → 列出候选，让你选
4. 无匹配 → 尝试 find-skills，仍无则回退到通用方式

技巧： 如果你觉得 Agent 选错了 skill，可以直接说「用 xxx skill 来做」，强制指定。

五、常见使用模式

模式 1：查询类（read-only）

查询类 skill 不会修改任何资源，可以放心使用：

帮我查一下当前账号的 OBS 桶列表和容量
帮我看看 cn-east-3 有哪些可用区
列出我的安全组规则

模式 2：创建/部署类

创建类 skill 通常需要确认。Agent 会在执行前说明将要做什么、影响哪些资源：

帮我创建一个 OBS 桶，名字叫 my-bucket-test，区域 cn-north-4
帮我用 Terraform 部署一个带 EIP 的 ECS

模式 3：多步编排

复杂任务需要多个 skill 配合。把完整目标说清楚，Agent 会自动编排：

帮我创建一个 VPC + 子网 + 安全组，然后在里面起一台 ECS

这会依次触发：网络创建 → 安全组配置 → ECS 创建。

模式 4：排障类

遇到问题时，先描述现象，Agent 会选择合适的查询 skill 来诊断：

我的 ECS 连不上，帮我排查一下

六、进阶技巧

1. 善用 tags 缩小范围

每个 skill 有 tags 标签（如 [huawei-cloud obs storage]）。如果你熟悉标签体系，在请求中带上相关术语可以加速匹配。

2. 区分 query 和 manage

很多产品有配套的两个 skill：

技巧： 只查不改时，query skill 更轻量、更快。

3. 注意 skill 的触发条件

每个 skill 的 description 里写了触发词（Triggers）。阅读触发词可以帮助你：

• 知道怎么说才能触发
• 避免误触发（比如 upload skill 不会仅凭 “upload” 一个词触发）

4. CRITICAL / MANDATORY 标记

部分 skill 标注了 CRITICAL 或 MANDATORY，表示必须先触发，不可绕过。即使任务看起来很简单，也要先走 skill 流程。这是安全护栏，不是限制。

5. 安装新 skill

从目录安装新 skill 很简单：

帮我安装管理 RDS 的 skill

Agent 会找到合适的 skill，执行安装命令，安装后立即可用，无需重启。

七、避坑指南

八、速查表