作为一名 专家，我将深入解析Agent Skills规范，帮助你构建高质量、符合要求的技Neng模块。本文旨在提供系统化的指导，确保你的技Neng在各种Agent环境中douNeng顺利运行。

核心概念：渐进式披露与SKILL.md文件格式

Agent Skills是为AI Agent赋Neng的关键组件。它们定义了AgentKe以执行的任务类型和操作步骤。理解其内部结构至关重要。其中，SKILL.md文件是定义技Neng的核心文档格式，遵循特定的规范来确保一致性和兼容性。

渐进式披露

渐进式披露是一种逐步揭示信息的策略，用于避免信息过载或不必要的复杂性。在Agent Skills的上下文中，这意味着技Neng描述应简洁明了只包含必要的信息，例如功Neng、使用场景和依赖项。

SKILL.md文件结构详解 基本字段

name: 技Neng的唯一标识符，如hello-world

description: 详细描述技Neng的功Neng和适用场景。

license: 许可协议信息。

compatibility: 指定环境依赖项。

metadata: 包含额外自定义属性。

allowed-tools: 授权使用的工具列表。

字段约束与验证 name字段

name字段是Skill的唯一标识符，用于激活Skill时必须匹配目录名, 使用小写字母、数字和连字符组合.

description字段

description 必须是非空字符串, 且长度控制在一定范围内.

license字段

# SPDX许可证标识license: Apache-# 引用许可文件license: Proprietary. LICENSE.txt has complete terms# MIT许可证license: MIT compatibility字段

graph TB subgraph "必需字段" A B end subgraph "可选字段" C D E F end style A fill:#4CAF50,color:#fff style B fill:#4CAF50,color:#fff style C fill:#2196F3,color:#fff style D fill:#2196F3,color:#fff style E fill:#2196F3,color:#fff style F fill:#FF9800,color:#fff metadata字段

# metadata：键值对映射；允许自定义属性；推荐使用独特的键名


Body内容指南推荐的内容组织## 使用场景说明什么时候应该使用这个 Skill...## 操作步骤. 第一步：准备工作. 第二步：执行操作. 第三步：验证结果##示例输入输出示例...##注意事项 -边界情况处理 -常见错误避免

---