全部產品
Search

搜尋本產品

    Microservices Engine：AI 治理中心 Skill 管理指南

    文件中心

    Microservices Engine：AI 治理中心 Skill 管理指南

    更新時間：May 22, 2026

    本文介紹 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 和資源檔、提交審核（Alibaba Content Security Service掃描）、發布版本、管理版本標籤、下線舊版本。

    版本狀態

    狀態

    說明

    草稿

    可編輯，支援修改 SKILL.md 和資源檔

    待發布

    已通過安全性稽核，等待手動發布

    發行

    正式版本，對外提供服務，內容不可修改

    建立草稿

    在詳情頁選中要基於的版本，點擊基於此版本建立草稿：

    1. 填寫新版本號碼（系統自動遞增，可手動修改）

    2. 點擊儲存為草稿

    說明

    草稿基於已有版本建立，需手動走完發布流程才會生效。

    編輯草稿

    選中草稿版本後，點擊編輯草稿進入編輯頁：

    • SKILL.md Tab：Markdown 編輯器 + 即時預覽，編寫 Skill 描述和使用說明

    • 檔案目錄 Tab：管理附帶的資源檔

    • 變更說明：記錄本次修改內容

    編輯完成後點擊儲存。儲存不會自動發布。

    刪除草稿

    選中草稿版本後點擊刪除草稿，確認後刪除。不影響發行版本。

    提交審核

    前置條件：如需對 Skill 內容進行安全掃描，需先開啟阿里雲的安全圍欄。具體開啟方式請參考 開通AI 安全護欄隨用隨付。

    草稿就緒後點擊提交審核，系統自動進行Alibaba Content Security Service掃描：

    • 提示詞攻擊檢測：檢查惡意提示詞注入

    • 內容合規檢測：檢查Alibaba Content Security Service規範

    點擊查看結果可查看每個檔案的掃描詳情。審核通過後版本進入待發布狀態。

    發布版本

    審核通過後點擊發布版本，確認後版本正式生效，對外提供服務。

    版本標籤

    選中發行版本，在版本標籤地區點擊編輯，為版本綁定語義標籤（如 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. 點擊提交審核，系統自動進行Alibaba Content Security Service掃描

    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，永久刪除

    刪除無法復原，建議先禁用觀察後再刪除。