跳转到内容

HiMarket Skills 市场指南

本文档面向 HiMarket AI 开放平台的管理员和开发者，提供 Skills 市场的完整操作指南。

如果你是管理员，本文将指导你完成 Skill 产品的创建、上传、版本管理和发布全流程；如果你是开发者，本文将帮助你了解如何浏览 Skills 市场、查看 Skill 详情、订阅并下载 Skill 包。

目录

Section titled “目录”

Skills 市场概述

Section titled “Skills 市场概述”

Agent Skill（智能体技能）是 HiMarket 平台中可被 Agent Worker 安装和使用的技能包。每个 Skill 封装了一组特定的 AI 能力（如工具调用、知识检索、代码生成等），开发者可以通过 Skills 市场浏览、订阅和下载所需的技能，快速增强 Agent 的能力。

核心概念：

  • Skill 产品：在 HiMarket 中以产品形式管理的技能，包含技能描述、文件内容、版本信息等
  • Skill 包：ZIP 格式的技能压缩包，包含技能描述文件和相关资源文件
  • 版本管理：支持草稿、审核中、上线、下线等多种版本状态，方便管理技能的生命周期

Skills 市场在 HiMarket 中的角色：

  • 管理员通过管理后台创建和管理 Skill 产品，上传技能包并发布到门户
  • 开发者通过开发者门户浏览 Skills 市场，订阅感兴趣的 Skill 并下载安装
  • Agent Worker 通过 CLI 工具拉取 Skill 包，实现技能的自动化安装

管理员操作流程

Section titled “管理员操作流程”

创建 Skill 产品

Section titled “创建 Skill 产品”

创建 Skill 产品是发布技能的第一步，需要在管理后台创建一个类型为 Skill 的产品。

操作步骤：

  1. 登录管理后台
  2. 进入【API Products】菜单
  3. 点击【创建 API Product】按钮
  4. 填写产品信息：
    • 产品名称：为技能取一个简洁明了的名称
    • 产品类型：选择 Skill
    • 产品描述：简要描述技能的功能和用途
    • 产品类别：选择或自定义类别，用于分类和筛选
    • 产品图标：选择图标 URL 或上传本地文件
    • Skill 标签：为技能添加标签，便于搜索和推荐
  5. 点击【确定】

说明：

  • 创建成功后，产品初始状态为 “待配置”
  • Skill 类型的产品不需要关联 API，而是通过上传 Skill 包来配置内容

上传 Skill 包

Section titled “上传 Skill 包”

创建 Skill 产品后，需要上传 ZIP 格式的 Skill 包。系统会自动解析包中的描述文件，提取技能名称、描述和指令内容。

操作步骤：

  1. 进入 Skill 产品详情页
  2. 点击【Skill Package】标签页
  3. 点击【上传 Skill 包】按钮
  4. 选择 ZIP 格式的 Skill 包文件（大小限制 10MB）
  5. 系统自动解析并显示解析结果

上传规则：

  • ZIP 包中必须包含 SKILL.md 描述文件
  • 描述文件中的技能名称和描述不能为空
  • 首次上传会创建新技能；后续上传会创建草稿版本
  • 支持文本文件和二进制文件（图片、字体、PDF 等）

注意事项：

  • ZIP 文件大小不能超过 10MB
  • 上传成功后，产品状态会自动更新

从 Nacos 批量导入 Skills

Section titled “从 Nacos 批量导入 Skills”

如果已有 Skills 存储在 Nacos 中，可以通过批量导入功能快速创建 Skill 产品。

操作步骤：

  1. 确保已在【实例管理】中导入了 Nacos 实例
  2. 进入【API Products】菜单
  3. 点击【导入 Skills】按钮
  4. 选择 Nacos 实例
  5. 选择命名空间（可选，默认使用 Nacos 实例的默认命名空间）
  6. 系统自动扫描 Nacos 中的 Skills 并创建对应的产品记录

导入结果：

  • 系统会返回导入结果，包括成功数量和失败详情
  • 已存在的 Skill 不会重复导入
  • 导入的产品会自动关联 Nacos 配置信息

查看 Skill 文件树和文件内容

Section titled “查看 Skill 文件树和文件内容”

上传 Skill 包后，可以在管理后台查看技能的文件结构和文件内容。

操作步骤：

  1. 进入 Skill 产品详情页
  2. 点击【Skill Package】标签页
  3. 左侧显示文件树结构，展示技能包中的所有文件和目录
  4. 点击文件名查看文件内容：
    • 文本文件：直接显示内容，支持语法高亮
    • Markdown 文件：支持渲染预览和源码查看
    • 二进制文件（图片等）：显示文件基本信息

文件树特性：

  • 目录优先于文件排列，同类型按字母顺序排序
  • 支持拖拽调整文件树宽度
  • 支持按版本查看不同版本的文件内容

版本管理

Section titled “版本管理”

Skill 支持完整的版本生命周期管理，包括发布版本、设置最新版本、上线/下线版本等操作。

版本状态说明：

状态说明
草稿新上传的版本，尚未提交审核
审核中已提交审核，等待通过
上线审核通过，对外可用
下线已下架，不再对外展示

操作步骤：

发布版本

Section titled “发布版本”
  1. 进入 Skill 产品详情页 → 【Skill Package】标签页
  2. 在版本列表中找到草稿版本
  3. 点击【发布】按钮，提交版本审核

设置最新版本

Section titled “设置最新版本”
  1. 在版本列表中选择一个已上线的版本
  2. 点击【设为最新】按钮
  3. 该版本将被标记为最新版本，开发者默认下载此版本

上线/下线版本

Section titled “上线/下线版本”
  1. 在版本列表中找到目标版本
  2. 点击【上线】或【下线】按钮切换版本状态
  3. 下线的版本不再对开发者可见

强制发布（紧急部署）

Section titled “强制发布（紧急部署）”
  1. 管理员可以使用【强制发布】功能，绕过审核流程直接发布版本
  2. 可选择是否同时将该版本设为最新版本
  3. 适用于紧急修复等场景

发布到门户

Section titled “发布到门户”

当 Skill 产品配置完成且有上线版本后，即可发布到门户供开发者使用。

操作步骤：

  1. 进入 Skill 产品详情页
  2. 确认产品状态为 “待发布”（已有上线版本）
  3. 点击【发布到门户】按钮
  4. 选择目标门户（可同时发布到多个门户）
  5. 点击【发布】

发布后：

  • Skill 会立即在门户的 Skills 市场中展示
  • 开发者可以浏览 Skill 详情、查看文件内容
  • 开发者可以订阅并下载 Skill 包

开发者操作流程

Section titled “开发者操作流程”

浏览 Skills 市场

Section titled “浏览 Skills 市场”

开发者登录门户后，可以在 Skills 市场中浏览所有已发布的技能。

操作步骤：

  1. 登录开发者门户
  2. 进入【Skills】页面
  3. 浏览技能列表：
    • 查看技能名称、描述、标签和下载量
    • 使用搜索和筛选功能查找感兴趣的技能
    • 按类别浏览不同类型的技能
  4. 点击技能卡片进入详情页

查看 Skill 详情

Section titled “查看 Skill 详情”

在 Skill 详情页，开发者可以查看技能的完整信息。

详情页包含：

概述标签页

Section titled “概述标签页”
  • 技能基本信息：名称、描述、作者、版本等
  • 技能使用说明：Markdown 格式的详细说明文档
  • 相关技能推荐：基于标签匹配的智能推荐

文件标签页

Section titled “文件标签页”
  • 文件树：展示技能包的完整文件结构
  • 文件预览：点击文件查看内容，支持语法高亮和 Markdown 渲染
  • 版本选择：切换不同版本查看文件内容

下载卡片

Section titled “下载卡片”
  • 版本列表：查看所有可用版本
  • 下载按钮：下载 ZIP 格式的 Skill 包
  • CLI 安装命令：一键复制安装命令

订阅 Skill

Section titled “订阅 Skill”

开发者需要先订阅 Skill 才能下载和使用。

操作步骤：

  1. 进入 Skill 详情页
  2. 点击【订阅】按钮
  3. 选择要使用的 Consumer（消费者）
  4. 点击【确定订阅】

说明：

  • 订阅审批取决于门户配置（自动审批或手动审批）
  • 订阅成功后即可下载 Skill 包
  • 可在 Consumer 详情的订阅列表中查看订阅状态

下载 Skill 包

Section titled “下载 Skill 包”

订阅成功后，开发者可以下载 Skill 包。

操作步骤：

  1. 进入 Skill 详情页
  2. 在下载卡片中选择版本（默认为最新版本）
  3. 点击【下载】按钮
  4. 浏览器自动下载 ZIP 格式的 Skill 包

说明：

  • 下载的 ZIP 包包含完整的技能文件
  • 每次下载会自动计入下载次数统计

CLI 安装方式

Section titled “CLI 安装方式”

HiMarket 提供 CLI 安装方式，开发者可以通过命令行直接安装 Skill。

操作步骤：

  1. 进入 Skill 详情页
  2. 在下载卡片中查看 CLI 安装命令
  3. 复制安装命令到终端执行

安装命令示例：

Terminal window
# Linux / macOS
npx @anthropic-ai/claw skill install \
  --nacos-host <nacos-host> \
  --nacos-port <nacos-port> \
  --namespace <namespace> \
  --skill-name <skill-name>

说明：

  • Skill 详情页会自动生成包含连接信息的安装命令，直接复制即可使用
  • 支持 Linux/macOS 和 Windows 平台
  • 安装命令会自动拉取 Skill 包并解压到指定目录

Skill 包格式说明

Section titled “Skill 包格式说明”

Skill 包是一个标准的 ZIP 压缩文件，包含技能描述文件和相关资源。

基本结构：

my-skill.zip
├── SKILL.md              # 必需：技能描述文件
├── scripts/              # 可选：脚本文件
├── prompts/              # 可选：提示词模板
├── config/               # 可选：配置文件
└── assets/               # 可选：资源文件（图片等）

ZIP 包也支持带有顶层目录的结构，即所有文件放在一个同名子目录下。

格式要求：

要求说明
文件格式标准 ZIP 压缩格式
大小限制不超过 10MB
必需文件SKILL.md 技能描述文件（位于根目录或一级子目录）

SKILL.md 描述文件：

SKILL.md 是 Skill 包的核心文件，用于描述技能的基本信息和使用指令。文件顶部包含技能的元数据（名称、描述、作者、版本等），其余部分为技能的指令内容，描述 Agent 应该如何使用这个技能。

必须填写的信息：

  • 技能名称：用作技能的唯一标识
  • 技能描述：简要说明技能的功能

可选信息：

  • 作者
  • 版本号
  • 源码仓库地址

指令内容支持完整的 Markdown 语法，包括列表、代码块、链接、表格等。

至此，你已了解 HiMarket Skills 市场的完整操作流程。无论是管理员发布技能还是开发者安装使用，Skills 市场都提供了便捷的工具和清晰的工作流，帮助你高效管理和使用 AI 技能。