功能简介

AgentWorks Skill 空间及 Skill 管理功能，为企业用户提供了一套完整的 Skill 资产隔离与管理方案。通过 Skill 空间实现资源隔离，通过 Skill 管理实现能力的上传、更新、分发与安装。

适用对象：AgentWorks用户，包括 Skill 空间管理员、Skill 开发者、Agent 运维人员。

核心概念

概念	说明
Skill 空间	Skill 的隔离容器。每个 Agent仅可在关联的 1 个或多个 Skill 空间范围内安装 Skill，不可安装其他来源的 Skill。
Skill	从属于 Skill 空间。不同空间下即使是同名同版本的 Skill，也属于彼此独立的副本。
Slug	Skill 的唯一标识，仅可包含小写字母、数字和连字符 -。在同一空间内 Slug + 版本号 唯一。
latest 版本	相当于指针，指向用户最新指定的版本，Agent 未指定版本安装时默认使用该版本。
跨空间加入	以源空间某版本为模板，在目标空间创建一份独立的 Skill 副本，两空间的 Skill 版本 彼此独立，不自动同步。

资源配额

• Skill 空间上限：最多可创建 100 个 空间
• Skill 版本上限：单空间下 Skill 版本（Slug + 版本号）最多 1000 个

一、Skill 空间管理

1.1 创建空间

操作路径：AgentWorks → 空间管理 → 创建空间

字段填写要求

字段	是否必填	说明
空间名称	必填	不超过 20 字符
空间描述	非必填	不超过 200 字符

空间总数达到 100 个后无法继续创建，请先删除不再使用的空间。

1.2 编辑空间

操作路径：AgentWorks → 空间管理 → 空间列表 → 编辑

可修改空间名称与空间描述，点击"保存"后自动刷新空间列表。

权限限制：用户不可编辑或删除自己没有权限的空间。

1.3 查询空间列表

操作路径：AgentWorks → 空间管理

支持通过 空间名称关键词 查询已有空间。

1.4 删除空间

操作路径：AgentWorks → 空间管理 → 空间列表 → 删除

删除规则

• 若空间已被任意 Agent 使用，删除按钮置灰，不可执行删除操作
• 若空间下存在 Skill，删除时将弹出二次确认提示
• 用户不可删除自己没有权限的空间

1.5 进入空间管理 Skill

操作路径：AgentWorks → 空间管理 → 空间列表 → 管理 Skill

点击后跳转至 Skill 管理页面，列表默认以该空间进行筛选。

二、Skill 管理

2.1 上传 Skill

系统提供两种上传方式，可根据 Skill 来源选择：

方式一：直接上传

上传本地已有的 Skill 压缩包，用于首次创建新 Skill 或为已有 Skill 增加新版本。

操作路径：AgentWorks → Skill 管理 → 上传 Skill

字段	是否必填	填写说明
Skill 名称	必填	上传后自动填充，可修改，不超过 100 字符
Slug	必填	上传后按 Skill 名称自动填充，仅保留小写字母、数字、连字符 -；不超过 100 字符
版本号	必填	不超过 10 字符
设为 latest	必填	首次上传时默认勾选且不可取消
Skill 描述	必填	上传后自动填充，可修改，不超过 1000 字符
所属空间	必填	仅可选择 1 个空间

版本数量：当目标空间下 Skill 版本数已达 1000 个时，无法提交，系统提示"当前空间内 Skill 版本已经超出 1000 个，请删除不再使用的 Skill 或版本"。

方式二：从其他空间加入

从当前用户有权限的其他空间中，将指定 Skill 的某个版本复制到目标空间。

操作路径：AgentWorks → Skill 管理 → 从其他空间加入

字段说明

字段	说明
源空间	必填。一次仅可选择 1 个源空间，可选范围为用户有权限的空间
目标空间	必填。一次仅可选择 1 个目标空间。目标空间下拉列表中已被选为源空间的项目置灰
Skill 名称	必填。已选择过的 Skill 显示为"XXX（已选择）"并置灰
添加版本	默认为最新版本；如所选版本与目标空间已有版本相同，则置灰不可选
设为 latest	目标空间已有该 Skill：勾选后加入版本即为 latest；目标空间无该 Skill：默认勾选，不可取消
目标空间已有版本	展示目标空间内该 Skill 的所有版本，并标出 latest
删除行	可删除当前行；当仅剩 1 行时不可删除
添加 Skill	在已有行下方新增一行，可批量添加

重名处理规则

判定依据：Slug 相同即视为重名。

规则：在同一空间内，Skill（Slug）+ 版本号 是唯一的。

• 加入的 Skill 与已有 Skill 版本不同 → 可正常添加
• 加入的 Skill 与已有 Skill 版本相同 → 不可选择

重要提示：加入操作 = 以源空间某版本为模板，在目标空间创建一份独立副本。加入后两空间的 Skill 版本 彼此独立，不会自动同步。

2.2 查询 Skill

操作路径：AgentWorks → Skill 管理

支持的筛选维度

按 所属空间 筛选

按 Skill 名称或简介关键词 联合查询

按 Skill 状态（创建中 / 创建失败 / 更新中 / 正常运行）筛选

2.3 Skill 详情

操作路径：AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 详情

详情页展示内容

模块	内容
基本信息	包括创建时填写的字段、当前状态、创建时间、更新时间
版本信息	该 Skill 的各版本列表，默认按更新时间倒序排列，支持 下载指定版本的 zip 文件 到本地
安装任务	展示历史安装任务：安装版本、目标 Agent 数、成功/失败数量、状态（进行中/已完成）、发起时间。鼠标 hover 失败数量可查看失败 Agent 实例 ID

2.4 更新 Skill

操作路径：

• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 更新
• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 详情 → 更新 Skill

字段规则

字段	规则
Skill 名称	带入原值，可编辑
Slug	带入原值，不可编辑
版本号	不可与已有版本号相同，否则提示"与已有版本号相同，请重新指定"
设为 latest	默认勾选。取消后，latest 仍为上一个设定的版本
所属空间	带入原值，不可编辑

跨空间同步说明：Skill 更新后若需要同步到其他空间，请通过"从其他空间加入 Skill"的方式，在目标空间选择相应的新版本添加。

2.5 移除 Skill

操作路径：

• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 移除
• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 详情 → 移除 Skill

2.6 安装 Skill 到 Agent

操作路径：

• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 安装
• AgentWorks → Skill 管理 → Skill 列表 → 选择某个 Skill → 详情 → 安装到 Agent

操作步骤

选择要安装的 Skill 版本（未指定时默认使用 latest 版本）

选择目标 Agent（支持多选；若已安装过该 Skill，将展示对应版本）

点击 "确认安装"，系统以 任务 形式下发指令并创建执行记录

在 Skill 详情的 安装任务历史 中查看任务执行状态与结果

并发限制：若当前有正在执行的安装任务，请等待前序任务完成后再发起新任务。

三、常见问题 FAQ

Q1：为什么我的 Agent 无法安装某个 Skill？

每个 Agent 只能安装其 关联的 Skill 空间 内的 Skill。请确认目标 Skill 所属空间是否已与 Agent 关联。

Q2：不同空间下同名的 Skill 是同一个吗？

不是。Skill 从属于空间，不同空间下即使 Skill 名称、Slug、版本号完全一致，也是彼此独立的副本，版本不会自动同步。

Q3：从其他空间加入 Skill 后，源空间更新，目标空间会自动更新吗？

不会。"从其他空间加入"仅在加入时以源空间的指定版本为模板复制一份副本，后续 两空间的版本彼此独立。如需同步新版本，需再次执行"从其他空间加入"操作，并选择对应的新版本。

Q4：空间下的 Skill 已经移除，为什么已安装的 Agent 还能继续使用？

移除操作仅影响后续的安装和版本切换。已安装的 Agent 仍会保留当前版本继续运行，但无法再从当前空间安装或切换到其他版本。

Q5：Slug 有什么用？可以修改吗？

Slug 是 Skill 的唯一标识，与版本号共同构成空间内的唯一键。Slug 一经创建，不可在更新时修改；仅支持小写字母、数字和连字符 -。

Q6：如何判断 Skill 安装是否成功？

在 Skill 详情 → 安装任务 列表中查看任务状态（进行中/已完成）、成功和失败的 Agent 数量。

Q7：达到空间或版本数量上限怎么办？

空间上限（100 个）：删除不再使用的空间后即可继续创建。

单空间 Skill 版本上限（1000 个）：请删除历史不再使用的 Skill 或版本后再进行上传。