使用 Skill 管理空间内容
Skill 是什么
Skill 是给 AI 助手的一组任务指引，说明助手如何理解目标、查找需要的信息、按步骤操作，并检查结果。使用者只需要描述想完成的任务，不必自己记住每一步操作。
Sylum Studio 数字资产管理助手的 Skill 名称是 sylum-manager。它通过 Studio 的 MCP 连接工作，可以查看工程、编辑注释与附件、整理中英文文案，以及编排数字场景的查看路线。
MCP 提供与当前 Studio 工程交互的能力，Skill 把这些能力组织成工作流程。使用 Skill 之前，需要先安装它，并完成 MCP 连接。
开始之前
Studio 和目标工程保持打开，MCP 服务器已经启用，并准备一个支持本机 MCP 和 Skill 的 AI 客户端。客户端需要能够访问 Studio 所在电脑上的配置。
安装 Skill
-
按 MCP 辅助创作 完成连接，确认 Studio 显示“已连接”。
-
取得分发版的
sylum-manager文件夹，把整个文件夹放入客户端的 Skill 目录。例如 Codex 的默认目录是~/.codex/skills/；设置了CODEX_HOME时，使用该目录下的skills/。其他客户端使用各自对应的 Skill 目录。 -
检查入口文件位于
skills/sylum-manager/SKILL.md，并且文件夹内的references目录一并保留。不要多套一层同名文件夹。 -
重新加载或重启客户端，然后发送：
使用
$sylum-manager查看当前工程，并推荐可以开始的操作。 -
等待助手确认当前工程和可用操作，再提出具体任务。
安装完成后，助手可以结合当前工程的信息执行支持的工作流。安装 Skill 不会自动配置 MCP；找不到 Studio 工具时，先检查连接。
能完成的任务
| 目标 | 可以怎样使用 |
|---|---|
| 查看资产 | 查找场景、注释、关联素材和当前画面 |
| 辅助编辑 | 修改指定注释的标题、正文或讲解内容 |
| 导入附件 | 给已有注释添加本机图片、音频或视频 |
| 翻译和润色 | 补充缺失翻译，或按指定要求统一文风 |
| 检查内容 | 查找空文案、缺失翻译或需要核对的不一致 |
| 编排路线 | 按注释的查看视角组织空间浏览路线 |
| 编排任务 | 沿路线截图、保存任务方案并继续未完成的步骤 |
实际可用的功能以 Studio 与客户端当前连接提供的能力为准。目标不明确时，先指定工程、场景或对象；存在同名对象时，帮助助手确认正确的目标。
案例：补充英文翻译
当前场景已有中文注释，希望补充缺失的英文，同时保留已有译文。
-
在 Studio 打开要处理的场景，并连接 AI 客户端。
-
先发送：
使用
$sylum-manager检查当前场景中哪些注释缺少英文，列出名称和缺失字段，先不要修改。 -
检查助手给出的范围和清单。确认需要补充时，再发送：
补齐这些注释缺失的英文，保留已有译文和中文原文；无法确认的人名或专有名词请列出来。
-
在 Studio 查看修改，确认术语、数字与原文一致，并检查保存状态。
助手会报告已补充、原本已有和需要人工确认的项目。只要求检查时，它给出清单；明确要求补充之后才执行修改。
案例：添加图片
要为某个注释补充一张保存在 Studio 电脑上的图片，同时保留已有的音频和视频。
-
确认目标注释的名称，并准备 Studio 所在电脑能够读取的图片绝对路径。
-
在客户端发送：
使用
$sylum-manager给当前场景的“入口介绍”注释添加图片C:\素材\入口.jpg，保留已有音频和视频。把示例路径换成实际的文件路径。
-
存在同名注释时，先根据助手列出的场景和对象信息确认目标。已有图片时，确认是否需要替换再提出要求。
-
在 Studio 打开注释，检查图片和其他附件，确认保存状态。
图片会添加到指定注释，其他媒体类型保持原样。文件必须位于 Studio 主机可以读取的位置；链接和客户端另一台电脑上的路径不能直接当作本机文件使用。
案例：编排浏览路线
已有多个注释，希望按主题组织一条数字场景的浏览路线。
-
为需要使用的注释设置合适的查看视角。
-
发送：
使用
$sylum-manager根据当前场景的入口、展品和出口注释，先提出一条浏览路线，列出站点顺序和理由，暂不创建。 -
检查助手找到的对象和顺序。需要保存时，再发送：
按刚才确认的顺序创建路线，命名为“展厅导览”。
-
回到 Studio 播放路线，检查镜头、停留和顺序；必要时调整并保存项目。
助手会基于现有注释创建路线，并报告实际使用的站点。路线用于数字场景中的相机浏览，不能据此判断现实空间是否可通行。
需要逐站留存画面时，可以继续要求：
沿这条路线逐站截图，保存任务方案，并报告每站结果。
截图和任务完成情况以助手实际返回的结果为准。
常见问题
找不到 Skill，或助手没有使用它
确认 sylum-manager 文件夹及其中的 SKILL.md、references 完整放在客户端的 Skill 目录，重新加载客户端，再用 $sylum-manager 指定技能。仍然不可用时，检查该客户端是否支持文件夹形式的 Skill。
已安装 Skill 但无法读取工程
确认 Studio 正在运行、目标工程已经打开、MCP 已经开启，客户端也显示连接成功。Skill 和 MCP 需要分别准备，具体排查见 MCP 辅助创作。
修改后网站不会自动更新
修改停留在 Studio 中。检查修改内容和保存状态，再按需要预览或重新部署。助手报告操作成功，不等于内容已经发布。
Skill 不控制实体设备
当前工作流只涉及 Studio 里的数字场景内容、视角、路线和任务，不控制实体机器人或其他现场设备。