SKILL 技能

技能（SKILL）是可复用的能力单元。蓝域（LanSphere）系统预置了官方技能，同时支持你导入或自行创建自定义技能，把成熟的业务能力沉淀为标准组件，再挂载到智能体上按需调用。

本文介绍技能的概念、SKILL 管理页的使用、技能商店、导入与创建技能的完整流程、三种技能类型，以及如何将技能挂载到智能体，适合开发人员与管理员阅读。

什么是技能

在智能体中，大模型负责理解意图与规划步骤，而技能负责把某一类具体事情做对、做稳：

可复用：一次创建，多个智能体共享，避免在每个应用中重复配置相同能力。
标准化：输入输出以 JSON Schema 明确定义，调用边界清晰。
来源多样：既可使用系统预置的官方技能，也可导入外部技能包，或基于代码、工作流、MCP 服务自行创建。

技能与插件、MCP 服务的区别在于：插件与 MCP 服务解决「能力从哪里来」，技能解决「能力如何被标准化地反复使用」。三者可组合——技能可以以插件或 MCP 工具作为执行载体。

SKILL 管理页

入口：左侧菜单 →「SKILL 管理」。页面包含「系统技能」与「自定义技能」两个标签页。

系统技能

展示已安装的系统技能列表，字段包括：

名称
类型
版本
描述
安装时间

你可以在此卸载不再需要的系统技能；点击「技能商店」入口可进入商店浏览并安装更多技能。

自定义技能

展示你导入或创建的全部自定义技能，列表支持编辑、删除与导出操作。页面提供两个入口：

导入技能文件：从本地导入现成的技能包。
创建技能：从零开始编排一个新技能。

技能商店

在技能商店中，你可以：

浏览官方与社区贡献的技能。
按名称搜索目标技能。
点击安装，安装后的技能出现在「系统技能」列表，即可挂载使用。

你也可以将自己的自定义技能发布到技能商店供全平台使用——发布需经管理员审核后方可上架；管理员同样负责技能的下架管理。

提示：发布前请确认技能描述清晰、调试已通过，便于审核与后续使用者理解其用途。

导入技能文件

适合从外部获取现成技能包的场景，步骤如下：

在「自定义技能」标签页点击「导入技能文件」。
选择本地文件：仅支持 .md、.zip 格式，单次最多导入 1 个。
如导入 zip 包，其根目录必须包含 SKILL.md 文件，否则导入失败。
技能名称与描述优先读取 SKILL.md 中的 name、description 字段，导入前可先检查该文件内容是否符合预期。

提示：单次只能导入 1 个文件；批量导入时请逐个操作。导入失败的常见原因是 zip 根目录缺少 SKILL.md，请先核对压缩包结构后重试。

创建技能

在「自定义技能」标签页点击「创建技能」，按以下五步完成：

基础信息：名称必填，不超过 30 字符；描述选填，不超过 200 字符；可设置图标。建议名称直接体现能力，便于在智能体中识别与勾选。
选择类型：在代码技能、工作流技能、MCP 技能中选择一种。
配置输入 / 输出参数：以 JSON Schema 定义技能的入参与出参。
配置执行逻辑：编写提示词，或选择内置工具（插件、MCP、自定义工具）作为执行载体。
调试并保存：调试运行验证效果，保存前必须至少成功调试一次；调试超时时间为 30 秒。

注意：同一空间内技能名称唯一，重名将无法保存；技能类型创建后不可修改，如需更换类型，请新建技能。

三种技能类型

类型	定义	适用场景
代码技能	以 Python / JavaScript 代码片段实现逻辑，定义输入输出 schema	需要精确、确定性处理的逻辑，如数据计算、格式转换
工作流技能	将已有工作流封装为技能	把已编排好的多步骤流程作为整体能力复用
MCP 技能	将 MCP 服务工具包装为技能，继承其认证与配置	复用已接入的外部系统能力

选择建议：

逻辑确定、可用代码表达的，优先代码技能。
已有成熟工作流的，直接封装为工作流技能，避免重复建设。
能力来自外部系统的，先接入 MCP 服务，再包装为 MCP 技能。

挂载到智能体

技能最终通过智能体发挥作用，挂载步骤如下：

进入目标智能体的「应用开发 → 工具配置」。
在「技能」分类中勾选已安装的技能。
保存后，大模型将根据用户意图自动决策调用时机，无需在提示词中硬编码调用逻辑。

你还可以为单个智能体配置允许或禁止调用的技能：同一技能可挂载给部分智能体，同时对另一些智能体禁用，实现精细化的能力管控。

权限

操作	阅览成员	开发人员	管理员
安装 / 使用系统技能	—	✓	✓
创建 / 导入 / 编辑 / 删除自定义技能	—	✓	✓
卸载系统技能	—	✓	✓
技能发布审核、下架	—	—	✓

提示：权限不足时会提示「您没有权限执行此操作，请联系管理员」。四种角色的完整定义与能力矩阵详见《成员与权限》。