SKILL 技能

技能（SKILL）係可重用嘅能力單元。LanSphere 系統預置咗官方技能，同時支援你匯入或自行建立自訂技能，將成熟嘅業務能力沉澱為標準組件，再掛載到智能體上按需調用。

本文介紹技能嘅概念、SKILL 管理頁嘅使用、技能商店、匯入同建立技能嘅完整流程、三種技能類型，以及點樣將技能掛載到智能體，適合開發人員同管理員閱讀。

咩係技能

喺智能體中，大模型負責理解意圖同規劃步驟，而技能負責將某一類具體事情做啱、做穩：

• 可重用：一次建立，多個智能體共享，避免喺每個應用中重複設定相同能力。
• 標準化：輸入輸出以 JSON Schema 明確定義，調用邊界清晰。
• 來源多樣：既可使用系統預置嘅官方技能，亦可匯入外部技能包，或基於程式碼、工作流、MCP 服務自行建立。

技能與插件、MCP 服務嘅分別在於：插件同 MCP 服務解決「能力由邊度嚟」，技能解決「能力點樣被標準化咁反覆使用」。三者可組合——技能可以以插件或 MCP 工具作為執行載體。

SKILL 管理頁

入口：左側選單 →「SKILL 管理」。頁面包含「系統技能」同「自訂技能」兩個頁籤。

系統技能

展示已安裝嘅系統技能列表，欄位包括：

• 名稱
• 類型
• 版本
• 描述
• 安裝時間

你可以喺呢度解除安裝唔再需要嘅系統技能；點擊「技能商店」入口可進入商店瀏覽並安裝更多技能。

自訂技能

展示你匯入或建立嘅全部自訂技能，列表支援編輯、刪除同匯出操作。頁面提供兩個入口：

• 匯入技能檔案：由本地匯入現成嘅技能包。
• 建立技能：由零開始編排一個新技能。

技能商店

喺技能商店中，你可以：

1. 瀏覽官方同社區貢獻嘅技能。
2. 按名稱搜尋目標技能。
3. 點擊安裝，安裝後嘅技能出現喺「系統技能」列表，即可掛載使用。

你亦可以將自己嘅自訂技能發佈到技能商店供全平台使用——發佈需經管理員審核後先可以上架；管理員同樣負責技能嘅下架管理。

提示：發佈前請確認技能描述清晰、調試已通過，便於審核同後續使用者理解其用途。

匯入技能檔案

適合由外部取得現成技能包嘅場景，步驟如下：

1. 喺「自訂技能」頁籤點擊「匯入技能檔案」。
2. 選擇本地檔案：僅支援 .md、.zip 格式，單次最多匯入 1 個。
3. 如匯入 zip 包，其根目錄必須包含 SKILL.md 檔案，否則匯入失敗。
4. 技能名稱同描述優先讀取 SKILL.md 中嘅 name、description 欄位，匯入前可先檢查該檔案內容係咪符合預期。

提示：單次淨係可以匯入 1 個檔案；批量匯入嗰陣請逐個操作。匯入失敗嘅常見原因係 zip 根目錄缺少 SKILL.md，請先核對壓縮包結構後重試。

建立技能

喺「自訂技能」頁籤點擊「建立技能」，按以下五步完成：

1. 基本資料：名稱必填，唔超過 30 字符；描述選填，唔超過 200 字符；可設定圖示。建議名稱直接體現能力，便於喺智能體中識別同勾選。
2. 選擇類型：喺程式碼技能、工作流技能、MCP 技能中選擇一種。
3. 設定輸入 / 輸出參數：以 JSON Schema 定義技能嘅輸入同輸出參數。
4. 設定執行邏輯：編寫提示詞，或選擇內建工具（插件、MCP、自訂工具）作為執行載體。
5. 調試並儲存：調試執行驗證效果，儲存前必須至少成功調試一次；調試逾時時間為 30 秒。

注意：同一空間內技能名稱唯一，撞名就冇辦法儲存；技能類型建立後唔可以修改，如需更換類型，請新建技能。

三種技能類型

選擇建議：

• 邏輯確定、可用程式碼表達嘅，優先程式碼技能。
• 已有成熟工作流嘅，直接封裝為工作流技能，避免重複建設。
• 能力嚟自外部系統嘅，先接入 MCP 服務，再包裝為 MCP 技能。

掛載到智能體

技能最終透過智能體發揮作用，掛載步驟如下：

1. 進入目標智能體嘅「應用開發 → 工具設定」。
2. 喺「技能」分類中勾選已安裝嘅技能。
3. 儲存後，大模型將根據用戶意圖自動決策調用時機，唔使喺提示詞中寫死調用邏輯。

你仲可以為單個智能體設定允許或禁止調用嘅技能：同一技能可掛載畀部分智能體，同時對另一些智能體停用，實現精細化嘅能力管控。

權限

提示：權限唔夠嗰陣會提示「您沒有權限執行此操作，請聯絡管理員」。四種角色嘅完整定義同能力矩陣詳見《成員與權限》。

相關閱讀

• 《智能體》：工具設定同技能編排嘅完整說明。
• 《插件與 MCP》：以 MCP 服務作為技能執行載體嘅接入方法。
• 《成員與權限》：角色權限體系全貌。