AI Agent Skill 深度研究报告

摘要： 本文系统回答了「什么是 AI Agent Skill？」这一核心问题。从定义与特征出发，详细解读华为云 SKILL.md 规范（frontmatter 格式、章节要求、目录结构、命名规则、质量门禁），从业界通用视角归纳 Skill 的 8 大能力类别（信息查询、事务操作、诊断分析、流程编排、监控告警、AI 调用、数据导出、合规治理），横向对比华为云、阿里云、MCP、OpenAI GPTs、AWS Bedrock、Azure Connectors 等 7 大平台的 Skill/插件设计差异，提炼出 5 个关键设计洞察（脚本优先架构、文档即代码、受控执行包装器、场景路由、三层诚实标注），并对 Skill 市场建设提出 4 条可落地的启示。
什么是 Skill？Skill 的规范是什么？能做什么？适用场景？业界如何设计？

一、什么是 AI Agent Skill

1.1 定义

AI Agent Skill（技能） 是一个自包含、可安装的能力扩展包，包含知识指令（SKILL.md）、参考文档（references/）和可执行脚本（scripts/），让 AI Agent 学会执行特定领域的工作。

它不是一段提示词，而是一个可安装、可审计、可版本管理的工程制品。

1.2 核心特征

1.3 Skill 与相关概念的区分

二、SKILL.md 规范（华为云标准）

2.1 文件格式

---
name: huawei-cloud-{product}-{function}
description: |-
  1. {英文功能范围}。{CLI 要求}。
  2. Triggered by: {触发词（中英文）}。
  3. {价值主张——解决什么问题}。
  4. Usage: {典型工作流，A → B → C 箭头表示}。
  5. {前置条件——CLI 版本、认证方式、环境变量}。
tags: [huawei-cloud, {tag1}, {tag2}]
---

Frontmatter 仅 3 个字段：

• name — 命名规范：huawei-cloud-{product}-{function}
• description — 编号列表格式（至少 5 行）：范围、触发词、价值、工作流、前置条件
• tags — 分类标签数组

2.2 正文章节要求

质量门禁：所有必需（✅）章节必须通过 + 推荐（★）章节 ≥ 80%。

2.3 目录结构

huawei-cloud-{product}-{function}/
├── SKILL.md                           # 必需——单一入口点
├── references/                        # 必需
│   ├── cli-installation-guide.md      # 必需（CLI 技能）
│   ├── iam-policies.md                # 必需
│   ├── verification-method.md         # 必需
│   └── ...                            # 其他参考文档
├── scripts/                           # 可选——可执行脚本
├── templates/                         # 可选——模板文件
└── tests/                             # 可选——测试用例

2.4 命名规范

huawei-cloud-{product}-{function}
示例：huawei-cloud-ecs-query、huawei-cloud-vpc-operations、huawei-cloud-cce-metric-analyzer
产品域目录：小写英文（bss, computing, storage）
产品子目录：小写英文缩写（billing, ecs, obs）
参考文档：kebab-case（cli-installation-guide.md）

2.5 语言规则

2.6 质量检查清单

必需通过项：

• SKILL.md 存在
• YAML frontmatter 含 name 和 description
• references/iam-policies.md 存在
• 必需章节：概述、前置条件、工作流、核心命令、参数确认
• 无硬编码凭据
• 无跨技能调用

强烈推荐项：

• 命名规范：huawei-cloud-{product}-{function}
• KooCLI 命令格式章节
• references/cli-installation-guide.md 存在

三、Skill 能做什么？能力与应用场景

Skill 的本质是将 Agent 从「通用对话」扩展到「专业执行」。不同平台对 Skill 的能力定义虽有差异，但核心应用场景可以归纳为以下 8 大类别。

3.1 信息查询与检索

最基础也是最广泛的能力——让 Agent 获取实时、准确的结构化数据。

典型工作流： 用户提问 → Skill 激活 → 构造查询 → 执行 API/命令 → 格式化结果 → 返回

3.2 创建与事务操作

Skill 让 Agent 从「只能读」变成「能写」——但要配合安全门禁。

典型安全模式： 展示变更内容 → 要求用户确认 → 执行 → 回读验证 → 记录审计日志

3.3 分析诊断与排查

利用 Agent 的推理能力 + Skill 的数据获取能力，替代人工排查。

与纯 LLM 的区别： 不靠模型「记忆」常见问题，而是 Skill 实际去查数据、跑诊断脚本，拿证据说话。

3.4 流程自动化与编排

Skill 可以串联多个步骤，形成完整的自动化工作流。

关键价值： 减少人在多个控制台之间切换的认知负担，Agent 记住上下文、维护状态、确保每一步顺序正确。

3.5 监控与告警

Skill 作为常驻监控点，定期检查系统状态并主动报告。

3.6 AI 能力调用

Skill 可以封装 AI 模型能力，让 Agent 做更多「生成类」任务。

3.7 数据导出与报告

Skill 可以将分散的数据汇总为结构化报告。

3.8 合规治理与运营

Skill 帮助团队维持长期的治理标准。

能力全景总结

                         Skill 能力层次
                             │
            ┌────────────────┼────────────────┐
            │                │                │
        被动响应          主动监控         主动编排
            │                │                │
    用户提问→Skill执行  定时触发→检查→报告  多技能协作→完成
            │                │                │
     ─── 典型场景 ───────────────────────────
    │ 信息查询   │ 事务操作   │ 诊断分析   │
    │ 流程编排   │ 监控告警   │ AI 调用    │
    │ 数据导出   │ 合规治理   │            │
     ──────────────────────────────────────

不同平台的 Skill 能力重点不同：华为云 Skills 侧重①④⑧（查询、编排、治理），MCP 侧重①②⑤（查询、分析、监控），OpenAI GPTs 侧重①②⑥（查询、事务、AI 调用）。但无论哪个平台，Skill 的核心价值都是把 Agent 从一个「聊天机器人」变成「领域专家」。

四、业界设计对比

4.1 生态对比总览

4.2 多维度对比

4.3 关键设计发现

华为云是基础设施 Agent Skill 的拓荒者

没有竞争对手提供预置的、即装即用的云基础设施操作 Skill。 AWS Bedrock 要求用户自己写 Lambda 函数。Azure 有 1,554 个连接器——但全部针对 SaaS 集成（Office 365、Salesforce），不是云资源操作。华为云的 61+ Skill 覆盖了云完整生命周期：计算、网络、存储、数据库、安全、财务、AI、DevOps。

脚本优先架构 vs 纯提示词

这是华为云 Skill 与其他生态最本质的安全差异：

SKILL.md 的双重身份

SKILL.md 不是传统意义上的「文档」——它同时扮演两个角色：

1. 文档：人类可读的安装指南、命令参考、最佳实践
2. 运行时指令：告诉 Agent 何时激活、按什么工作流执行、调哪些脚本、遵守什么安全规则、如何验证结果

这与 OpenAPI 规范或普通 README 有本质区别——那些只有人类读，SKILL.md 是人机共读的。

五、Skill vs 其他 Agent 扩展机制

5.1 Skill vs MCP

5.2 Skill vs OpenAI GPTs/Plugins

5.3 Skill vs AWS Bedrock Agents

六、总结与启示

6.1 核心结论

1. AI Agent Skill 是自包含、可安装的能力扩展包——结合指令（SKILL.md）、文档（references/）、可执行脚本（scripts/），与 Plugin（纯 API）、Tool（单函数）、MCP Server（网络协议）有本质区别。

2. SKILL.md 规范（华为云标准）定义了精确格式：3 字段 YAML frontmatter + 10 章正文（6 必需 + 4 推荐）+ 3 个必需参考文档。

3. 能力覆盖云完整生命周期：资源管理、故障排查、成本优化、安全合规、AI 模型调用、Terraform/IaC、多步骤验证工作流。

4. 华为云是基础设施 Agent Skill 的行业拓荒者（61+ 已发布）——AWS Bedrock 零预置、Azure Connectors 面向 SaaS 而非基础设施、MCP 约 19 个文件/开发工具。

5. 5 个设计创新独一无二：

   • 脚本优先架构（非纯提示词）保障安全
   • SKILL.md 人机共读的双重身份
   • safe_exec 受控执行包装器
   • 场景路由优于 API 端点发现
   • 三层诚实标注机制

6.2 对 Skill 市场建设的启示