功能说明
Skill 是 Agent 的原子能力单元，用于描述"这个 Agent 能做什么"。对外它对应 A2A 协议 AgentCard 中的
AgentSkill 对象（id/name/description/tags/examples），对内是 AI 网关侧一条可复用的能力配置记录。同一个 Skill 可被多个 Agent API 复用，修改一次即可同步生效。
AI 能力市场提供两个页面，对应 Skill 的两种视角：
Skill 管理：私有管理视角。用于创建、编辑、版本管理与生命周期治理。
SkillHub：公开分发视角。用于搜索与下载已发布的 Skill。
前提条件
已创建 AI 网关类型的云原生 API 网关实例，且实例状态为运行中。
若需将 Skill 挂载到 Agent 并通过 A2A 协议对外暴露，网关数据面版本需 ≥ 3.9.5。
若使用 ZIP 包方式创建 Skill，需提前准备包含
SKILL.md 的压缩包。Skill 管理
创建 Skill
1. 登录 AI 网关控制台。
2. 在左侧导航栏选择实例列表，单击目标 AI 网关实例 ID 进入实例详情页。
3. 选择 AI 能力市场 > Skill 管理，单击新建 Skill。
4. 在新建 Skill 弹窗中配置基础信息：
参数名 | 是否必填 | 取值范围/默认值 | 说明 |
Skill 名称 | 是 | 最长 64 个字符 | 展示名称，如“TAPD-Test”。 |
描述 | 是 | 最长 255 个字符 | 一句话描述能力，写入 AgentCard skills[].description，对外可见。 |
Tags | 是 | 最多 5 个，单个最长 20 个字符 | 不可重复。写入 AgentCard skills[].tags。支持 Enter / 逗号 / 空格添加，Chip 形式展示，单击 × 删除。 |
Examples | 否 | 最多 10 条，单条最长 512 个字符 | 使用示例，写入 AgentCard skills[].examples。单击添加示例新增一行。 |
5. （可选）在 Skill 文件区域上传 ZIP 包：
参数名 | 是否必填 | 取值范围 | 说明 |
Skill 文件（.zip） | 否 | 仅支持 .zip 格式 | 支持拖拽或单击上传。上传后系统自动解析 SKILL.md 中的元信息（名称/描述/标签）并回填至上方字段，仅在字段为空时回填，不覆盖已填内容。 |
6. 单击确定创建，列表中出现新建的 Skill。
查看 Skill 详情
1. 在 Skill 管理列表中单击目标 Skill 名称进入详情页。
2. 详情页包含以下页签：
页签 | 内容 |
基本信息 | Skill ID、名称、描述、Tags、Examples、当前版本号、状态、创建人、创建/更新时间 |
SkillHub
浏览与搜索 SkillHub
当前 skill 管理页面新建的 skill 默认同步到 skillhub。
1. 在左侧导航栏选择 AI 能力市场 > SkillHub。
2. 页面以卡片形式展示当前租户内所有已发布的 Skill，每张卡片包含名称、描述、Tags（最多展示 3 个）、创建人与 ZIP 包上传标识。
3. 可通过以下方式筛选：
筛选项 | 取值范围 | 说明 |
关键词搜索 | 最长 60 个字符 | 对 Skill 名称、ID、描述做模糊匹配，大小写不敏感 |
标签筛选 | 从已有 Tags 中选择 | 按标签精确过滤，为真实过滤能力（非仅视觉切换） |
