AI 助理
文档备案控制台
官方文档
输入文档关键字查找
首页

AI 治理中心 Skill 管理指南

更新时间：
复制为 MD 格式
产品详情
我的收藏

本文介绍 AI Registry（AI 治理中心）的 Skill 管理功能，包括 Skill 的创建、版本管理、发布上线和下载使用。

前提条件

核心概念

概念

说明

Skill

一个 AI 技能单元，由 SKILL.md 描述文件和可选的资源文件组成。

版本（Version）

Skill 内容的一个快照，遵循语义化版本号（如 0.0.1、0.0.2）。

草稿（Draft）

版本发布前的可编辑状态，修改不影响已发布内容。

版本标签（Label）

版本的语义别名，如 latest，消费方通过标签引用而非具体版本号。

可见性（Scope）

控制 Skill 对其他用户是否可见：公开（所有人可见）/ 私有（仅自己与指定用户可见）。

业务标签（BizTags）

用于业务分类和检索的标签。

启用/禁用

Skill 级别的服务状态控制，禁用后所有版本不再对外提供服务。

Skill 生命周期

版本发布流程：

创建/导入 → 编辑草稿 → 提交审核（安全扫描） → 发布版本
    ↑                                       ↓
    └──────────── 新版本迭代 ←────────────────┘

独立操作：

  • 启用/禁用（Skill 级别）：控制 Skill 整体是否对外提供服务，不影响版本发布流程。

  • 上线/下线（版本级别）：控制单个已发布版本是否对外可用。

进入 Skill 管理页面

  1. 登录阿里云控制台，进入微服务引擎 MSE 产品页面。

  2. 在左侧导航栏中选择 AIRegistry，进入 AI 治理中心。

  3. 在左侧导航栏 AI 资源管理 下选择 Skill，进入 Skill 管理页面。

  4. 在页面顶部的工作空间下拉框中选择目标工作空间，即可查看该工作空间下的 Skill 列表。

说明

如果当前没有可用的工作空间，需要先在左侧导航栏的工作空间页面中点击创建工作空间完成创建，再回到 Skill 管理页面选择该工作空间。

操作指南

权限说明

  • 只有 Skill 的 Owner 才能执行编辑、发布、删除、上下线等写操作。

  • 非 Owner 用户在详情页看到的写操作按钮不可用。

  • PRIVATE 的 Skill 仅 Owner 可在列表中看到。

Skill 列表页

查看当前工作空间下的所有 Skill，支持按名称搜索、按可见范围筛选、按下载量排序，每个 Skill 卡片展示名称、版本、下载数、在线数等关键信息。

浏览 Skill

进入Skill 管理页面后，展示当前工作空间下的所有 Skill。每个 Skill 卡片展示：

  • 名称、描述、可见性（公开/私有）

  • 最新发布版本号、下载次数、在线使用数

  • 业务标签、作者

  • 启用状态

点击卡片进入 Skill 详情页。

搜索与筛选

  • 搜索：在顶部搜索框输入关键词，按 Skill 名称模糊匹配

  • 按可见范围筛选：所有范围 / 仅公开 / 仅私有

  • 排序：默认排序（按修改时间）或按下载量排序

创建入口

列表页右上角有两个入口：

  • 导入 Skill：通过上传文件或 CLI 导入已有 Skill

  • 新建 Skill：手动创建新 Skill

创建与导入 Skill

通过控制台手动新建 Skill（填写名称、描述、标签、可见性并编写 SKILL.md），或通过 Nacos CLI 命令行工具导入本地已有的 Skill 文件夹。

新建 Skill

在 Skill 列表页点击右上角+ 新建 Skill按钮，进入手动创建页面。

操作步骤：

  1. 填写基础信息：

    • Skill 名称（必填）：最多 64 个字符，用于标识 Skill。

    • 描述（必填）：最多 1000 个字符，描述 Skill 的功能和用途。

    • 标签：输入标签内容后按回车确认，用于业务分类和检索。

  2. 展开高级选项，可设置可见性：

    • 私有（默认）：仅自己与指定用户可见。

    • 公开：所有人可见。

  3. 编写 SKILL.md 内容（必填）：使用 Markdown 格式编写 Skill 的详细描述和使用说明。编辑器提供左侧代码编辑和右侧实时预览

  4. 点击右上角立即创建完成。

创建成功后，系统自动生成初始版本（草稿状态），可在 Skill 列表中看到新记录。

导入 Skill

在 Skill 列表页点击「导入 Skill」按钮，支持两种导入方式：

方式一：上传文件

选择本地 Skill ZIP 包直接上传。适合已在本地开发完成的 Skill。

方式二：Nacos CLI

通过命令行工具导入本地 Skill 文件夹，适合开发者日常工作流。

操作步骤：

  1. 首次使用，配置登录凭证，参考Nacos CLI 接入 AI 治理中心：

npx @nacos-group/cli profile edit

  1. 通过命令行将本地 Skill 文件夹导入：

npx @nacos-group/cli skill-publish xxx-skill

Skill 版本与草稿管理

管理 Skill 版本的完整生命周期：创建草稿、编辑 SKILL.md 和资源文件、提交审核（内容安全扫描）、发布版本、管理版本标签、下线旧版本。

版本状态

状态

说明

草稿

可编辑，支持修改 SKILL.md 和资源文件

待发布

已通过安全审核，等待手动发布

已发布

正式版本，对外提供服务，内容不可修改

创建草稿

在详情页选中要基于的版本，点击基于此版本创建草稿：

  1. 填写新版本号（系统自动递增，可手动修改）

  2. 点击保存为草稿

说明

草稿基于已有版本创建，需手动走完发布流程才会生效。

编辑草稿

选中草稿版本后，点击编辑草稿进入编辑页：

  • SKILL.md Tab：Markdown 编辑器 + 实时预览，编写 Skill 描述和使用说明

  • 文件目录 Tab：管理附带的资源文件

  • 变更说明：记录本次修改内容

编辑完成后点击保存。保存不会自动发布。

删除草稿

选中草稿版本后点击删除草稿，确认后删除。不影响已发布版本。

提交审核

前置条件：如需对 Skill 内容进行安全扫描，需先开启阿里云的安全围栏。具体开启方式请参考 开通AI 安全护栏按量付费。

草稿就绪后点击提交审核，系统自动进行内容安全扫描：

  • 提示词攻击检测：检查恶意提示词注入

  • 内容合规检测：检查内容安全规范

点击查看结果可查看每个文件的扫描详情。审核通过后版本进入待发布状态。

发布版本

审核通过后点击发布版本，确认后版本正式生效，对外提供服务。

版本标签

选中已发布版本，在版本标签区域点击编辑，为版本绑定语义标签（如 latest）。

消费方通过标签引用 Skill，版本更新时调整标签指向即可，对消费方透明。

下线版本

选中已发布版本后点击下线版本，将该版本从服务中移除，其他版本不受影响。

如需整体停止服务，请使用禁用 Skill。

下载与使用 Skill

通过手动下载 ZIP 文件或 NPX 命令行工具（支持 QwenPaw、Qoder、Claude、Cursor 等多种 CLI）将 Skill 下载到本地使用。

手动下载

在 Skill 详情页右侧使用指南区域，点击下载 .zip 文件，下载当前版本的完整 Skill 包。

适用于本地查看、备份或迁移到其他环境。

通过 CLI 下载

在详情页右侧NPX 下载区域，选择对应的 CLI 工具后按步骤操作：

支持的 CLI 工具： QwenPaw、OpenClaw、Qoder、QoderWork、Claude、Codex、Cursor、Kiro、Lingma

步骤：

  1. 首次使用，配置登录凭证，Nacos CLI 接入 AI 治理中心：

npx @nacos-group/cli profile edit

  1. 下载 Skill 到本地：

npx @nacos-group/cli skill-get <skill-name> --version <version> -o <output-path>

不同 CLI 工具有各自的默认 Skill 存储路径，页面会根据选择自动生成对应命令。

Skill 详情与设置

在 Skill 详情页查看版本内容和 Skill 信息，执行修改可见性、启用/禁用、编辑业务标签、删除 Skill 等设置操作。

查看详情

在详情页可以查看和操作：

  • 版本内容：通过左上角版本下拉切换不同版本，查看 SKILL.md 内容和资源文件

  • 版本标签与变更说明：当前版本绑定的标签及发布说明

  • Skill 信息（右侧）：可见性、启用状态、作者、业务标签、描述

  • 使用指南（右侧）：下载方式和 CLI 命令

修改可见性

在右侧 Skill 信息区域切换可见性开关：

  • 私有：仅自己与指定用户可见

  • 公开：所有人可见

切换时会弹出确认提示，确认后生效。

启用与禁用

在右侧 Skill 信息区域切换启用状态：

  • 禁用：所有版本停止对外服务

  • 启用：恢复对外服务

禁用是 Skill 级别操作，影响所有版本。如需仅控制单个版本，请使用下线版本。

编辑业务标签

在右侧 Skill 信息区域点击业务标签旁的编辑，输入标签后按回车添加，支持多个标签。

删除 Skill

点击右上角删除 Skill，确认后永久删除该 Skill 及所有版本，操作不可逆。

常见操作场景

场景一：首次创建并发布 Skill

  1. 在列表页点击+ 新建 Skill，填写名称、描述、标签，编写 SKILL.md，点击立即创建

  2. 进入详情页，确认内容无误

  3. 点击提交审核，系统自动进行内容安全扫描

  4. 扫描通过后，点击发布版本

  5. 开启启用状态，根据需要将可见性切换为公开，添加业务标签

场景二：版本迭代

  1. 在详情页选中当前已发布版本，点击基于此版本创建草稿

  2. 点击编辑草稿，修改 SKILL.md 或资源文件，保存。

  3. 点击提交审核，等待安全扫描通过

  4. 点击发布版本

  5. 编辑版本标签，将 latest 指向新版本

  6. 确认新版本正常后，下线旧版本

场景三：通过 CLI 导入已有 Skill

  1. 配置 CLI 登录凭证：npx @nacos-group/cli profile edit

  2. 导入本地 Skill 文件夹：npx @nacos-group/cli skill-publish <skill-folder>

  3. 在控制台列表中确认 Skill 已创建

  4. 进入详情页完成审核和发布流程

场景四：下载 Skill 到本地使用

  1. 进入目标 Skill 详情页

  2. 选择下载方式：

    • 手动下载：点击下载 .zip 文件。

    • NPX 下载：执行 npx @nacos-group/cli skill-get <name> --version <ver> -o <path>

  3. 下载完成后即可在本地 CLI 工具中使用该 Skill

场景五：紧急下线 Skill

当发现 Skill 存在问题需要紧急停止服务时：

  • 停止单个版本：在详情页选中目标版本，点击下线版本

  • 停止整个 Skill：在右侧 Skill 信息中将状态切换为禁用，所有版本立即停止服务

恢复时反向操作即可。

场景六：清理不需要的 Skill

  1. 禁用 Skill，观察一段时间确认无影响

  2. 在详情页点击删除 Skill，永久删除

删除不可逆，建议先禁用观察后再删除。

上一篇：AI 治理中心 Prompt 管理指南下一篇：实践教程