管理 Skills
Skill 是给 Agent 使用的说明和资源。桌面端把 资料库中的 Skill、在 Work 中启用的 Skill 和 部署到本机 Agent 的副本 分开管理；把 Skill 加入资料库，不会自动启用，也不会自动写入某个 Agent 的配置目录。
从社区获取
- 在 Lumoswitch 桌面端侧栏打开 Skills，选择 获取更多，进入社区目录。
- 打开你感兴趣的 Skill，先查看说明、来源、兼容性和所需依赖。
- 选择 安装。返回 Skills 资料库后，该 Skill 会显示为已安装；这一步只是加入本机资料库。
- 展开 详情与使用设置，检查 Skill 声明的能力、来源和 Agent 使用情况。确认可信后，打开 允许在工作中使用。如果出现权限检查窗口，先核对再选择 确认并启用；部分 Skill 无需弹窗，会直接启用。
从 GitHub 或本机文件夹导入
导入 GitHub Skill：在 Skills 资料库选择 从 GitHub，填写公开的 github.com 仓库地址。可选填写仓库内的 Skill 子目录，以及分支、标签或提交；随后选择 导入 Skill。客户端只支持公开仓库，导入的副本保存在本机并默认停用。页面会显示解析到的仓库与提交；检查 SKILL.md 和来源后再启用。需要更新时，先检查更新，核对变更的提交，再确认下载；更新后的 Skill 会停用，需要再次检查并启用。
导入本机 Skill：选择 导入文件夹，选中包含标准 SKILL.md 的文件夹。导入成功后，可在资料库的 本地 筛选中找到它。若没有 Lumoswitch 权限清单，客户端会提示无法仅凭元数据验证能力；启用前请阅读 SKILL.md 和源文件。
部署到本机 Agent
部署是独立操作：在已安装的 Skill 行选择 安装到 Agent，选一个已检测到的本机 Agent。检查安装窗口中的权限和目标位置，以及显示的兼容性或依赖提示；勾选同意安装的确认项，再选择 确认安装。成功后，可在详情中的 Agent 使用情况或本机位置查看部署状态。Agent 是否实际加载 Skill 仍需在对应 Agent 中确认；若未生效，按客户端提示重新检测，必要时开启新会话或重启 Agent。
允许在工作中使用让 Skill 可用于 Lumoswitch Work；安装到 Agent则将副本放入所选本机 Agent 的 Skills 位置。启用与部署是不同操作，但停用或更新资料库 Skill 还会影响已有的受管 Agent 绑定，不能理解为只影响 Work。
停用、更新和重新绑定
停用或更新 Skill 前，先查看确认窗口列出的受影响 Agent。 停用会清除已有的受管 Agent 绑定；更新也会清除这些绑定，并让新版本保持停用。重新启用不会自动恢复原绑定。 移除资料库 Skill 同样会清除这些绑定。受影响的 Agent 可能显示需要重新同步。
如需恢复使用：
- 检查当前版本的内容和权限，在 Skills 资料库重新启用。
- 打开受影响的 Agent 配置，重新选择需要的 Skill，预览并应用；按页面提示完成同步，再在 Agent 中确认已加载。
- 通过 安装到 Agent 单独部署的本机副本另行管理，不会随资料库更新自动升级，也不能靠关闭资料库开关保证停用。到本机部署管理中检查版本和状态，按需更新、重新部署或移除，并在目标 Agent 中验证结果。
这些操作不会替你安装 Agent 的运行依赖。遇到缺少依赖或同名文件冲突时，先处理页面提示，无需清空整个资料库。
权限与常见问题
- 出现权限检查时仔细核对。 Skill 需要审核时，窗口会列出请求的能力与范围，例如读取或修改工作区文件、运行命令、联网、读取已配置密钥或访问工作区外文件。部分 Skill 无需弹窗即可启用。来源不明、能力范围不清或声明权限变化时，先取消并检查源文件。
- 启用不等于免确认。 启用 Skill 不会自动批准文件修改、命令执行、工作区外访问或联网；Work 仍按你的授权设置请求确认。
- 安装按钮不可用或部署受阻：展开详情查看兼容性和依赖提示。按提示安装缺少的依赖、选择受支持的 Agent，或处理同名文件冲突；客户端不会替你安装所有第三方运行时和命令。
- 找不到已导入的 Skill：检查资料库筛选器是否选为 全部 或 本地，并清除搜索词。确认本地文件夹内有
SKILL.md。 - 本机 Agent 未加载：检查详情中的部署位置和状态；Agent 的登录、运行时依赖与本机权限需分别满足。成功部署提示只说明文件已放入目标位置，不代表 Agent 已加载或运行 Skill。