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 服務作為技能執行載體的接入方法。
• 《成員與權限》：角色權限體系全貌。