Skill 管理
编排器面板的管理 Skills按钮打开一个子面板，里头可以安装、编辑、迁移、删除 Skill。本页逐一过一遍每个入口。
在哪里找
打开扩展抽屉 → 多智能体编排 节 → 点面板底部附近的管理 Skills。子面板以弹窗形式覆盖在编排器配置之上。
子面板概览
Skill 管理顶部有三个 tab：
- 已安装 —— 你
data/<user>/skills/<scope>/下有什么。按作用域过滤（全局 / 预设 / 角色卡）或选全部。 - 浏览出厂 ——
default/skills/global/自带的 24 个 Skill，每行显示你本地副本是匹配、有差异，还是没装。 - 导入 —— 从文件、URL，或角色卡 / 预设里抽出 Skill 的入口。
Tab 1 —— 已安装
每行显示：
name—— Skill frontmatter 里的name。点击打开内嵌编辑器。description—— frontmatter 里的一行摘要。scope—— 作用域 chip（global/preset/<api>/<name>/character/<file>）。size—— 文件数 + 总字节数。- 被引用 —— 当前编排器 profile 中可见列表引用了该 Skill 的 agent 数量 chip。
行内动作（右侧）：
| 动作 | 作用 |
|---|---|
| 查看 | SKILL.md 的只读 Markdown 渲染。 |
| 编辑 | 打开内嵌编辑器（见下文 内嵌编辑器）。 |
| 迁移到…… | 原子级跨作用域 move。引用（仅按名字）依然有效。 |
| 改名 | 在当前作用域内原子改名。目录与 frontmatter name 同步更新。指向旧名的引用变灰（见 失效引用）。 |
| 删除 | 删除 Skill 目录。引用继续变灰，而不是阻断派遣。 |
批量选择
顶栏切到多选模式后，每行多一个复选框。勾选至少一项后，工具栏会多一个**把所选打包进预设……**动作 —— 见下文 嵌入导出。
Tab 2 —— 浏览出厂
「浏览出厂」tab 把你本地每个出厂 Skill 的副本和 default/skills/global/ 里的版本对比。每行显示三种状态之一：
| 标记 | 含义 |
|---|---|
| 已安装（一致） | 本地副本与出厂版本逐字节一致。 |
| 已安装（你的版本有差异） | 本地副本存在，但哈希与出厂版本不匹配 —— 你（或某次迭代工作台会话）改过它。 |
| 未安装 | 本地没有副本。点击安装把它落到 global。 |
tab 顶部的全量导入出厂按钮，是对每个「未安装」或「有差异」行点安装的便捷等价 —— 它会用出厂版本覆盖全部 24 个出厂 Skill。
覆盖是破坏性的
全量导入出厂不会合并 —— 它直接覆盖。如果你本地改过 event-summary-rules-zh，导入出厂版本会冲掉你的修改。按钮标签会在点击前明确告诉你即将覆盖多少个同名 Skill。
Tab 3 —— 导入
四个入口：
从文件导入
上传一个包含单个 Skill 目录的 .zip。服务端校验存档，预览每个 Skill 的冲突状态（每 Skill：新 / 相同 / 不同），然后等你对每个冲突做决定再提交。
从 URL 导入
粘贴一条 https://... URL，指向一份原始 SKILL.md。服务端拉下来后作为单文件 Skill 安装（无子文件）。多文件 Skill 用从文件导入走 zip 路径。
只接受 HTTPS、只接受原始 SKILL.md
URL 导入器有意做窄 —— 它只抓一份 Markdown 文件。再复杂（多文件、二进制）的就走 zip 路径。导入面保持小而可预测。
导入出厂
跟「浏览出厂」tab 的全量导入出厂是同一个动作，这里列出便于发现。
从角色卡 / 预设抽取
导入带 embedded_skills_source 字段的角色卡（PNG）或预设（JSON）时，Luker 会自动弹出预览对话框：
对话框逐项列出每个嵌入的 Skill 及其冲突状态。对每个冲突，你可选跳过（保留本地版本）或替换（用嵌入里的版本）。内容相同的项（相同）会静默不操作；新条目（新）直接安装。
抽取后角色卡 / 预设磁盘文件里的嵌入载荷被移除 —— Skill 现在住在 skills/character/<file>/ 或 skills/preset/<api>/<preset>/ 里。这样避免「过期嵌入」陷阱：内联载荷与已落地的文件版本不一致。
内嵌编辑器
点击 Skill 行的编辑会打开弹窗内编辑器：
- 左栏：文件树（SKILL.md + 任何子文件）。点击切换。
- 右栏：Markdown 编辑器，frontmatter 区段有 YAML 感知高亮。
- 顶栏：文件路径、未保存标记、保存（走
.staging/并原子提交）、新增文件（在你指定的路径创建一份新子文件）。
写入跟安装走同一套 .staging/ 纪律：新内容先经过校验（路径安全、大小限额、frontmatter 解析），全部通过后 staging 文件原子地替换原文件。失败的写入对原文件零影响。
SKILL.md 是特殊的 —— 你能编辑它但不能从编辑器里删它（它是必需入口）。Skill 本身可通过行内动作整体删除。
不想手动改？
AI 迭代工作台 也能替你写和修改 Skill —— 用一句话描述变更，工作台通过相同的安装路径起草。要新建一个 Skill、或者把已有 Skill 重写一遍而不想自己敲 Markdown 时很省事。
嵌入导出 —— 到预设和角色卡
Skill 在跟它所依赖的产物（角色卡、预设）一起分发时最有用。某张角色卡需要某条口吻规则，某个预设是为特定子代理调出来的 —— 两者都能把 Skill 内联打包。
打包进预设
在编排器面板里，补全预设助手 会派生出一份 -orchestrator 预设。派生紧接着，助手在工具栏给出一条为该预设打包 Skills链接，点开后会进入 Skill 管理并自动开启多选模式。挑你想要的 Skill，点把所选打包进预设……，再选目标预设。
打包器把这些 Skill 写进预设的 extensions.luker.embedded_skills_source 字段。下一次保存预设时，嵌入随 JSON 一起被持久化。其他 Luker 用户导入这份预设时会看到上文描述的嵌入抽取对话框。
打包进角色卡
在角色卡编辑器里，出厂 Skill 区段也是同样的逻辑：选 Skill、打包，它们写进 data.extensions.luker.embedded_skills_source。PNG 导出时嵌入序列化进卡的元数据，分发这张卡也就分发了 Skill。
内联 vs zip 的阈值
小且只含文本的 Skill 走 inline-files-v1 格式（Markdown 内容直接内嵌）。更大或带二进制的 Skill 自动升级到 archive-base64-v1（zip + base64 + sha256）。打包器按每 Skill 自动决定，你不用选。
作用域迁移
通过行内动作迁移到……，你随时可以把 Skill 从 global → preset → character（或反向）挪。迁移是一次原子文件系统重命名 —— 没有拷贝，没有中间状态。
这为什么安全：编排器 profile 只按名字引用 Skill，永远不带作用域前缀。名为 voice-rules 的 Skill 不管当前在哪个作用域，都按后者优先（character > preset > global）解析。迁移不破坏任何引用；它只改变 Skill 何时可见。
典型迁移：
global→character—— 你写了一条写作规则、用在多张卡上，后来发现某张卡需要一份专门变体。把它迁到那张卡的作用域，让更通用的版本留在global。两者共存；卡片加载时按卡的版本胜出。preset→global—— 你打包在某个预设里的 Skill 后来发现到处都有用。把它提升到全局。character→global—— 某个角色卡专属 Skill 最终泛化了。提升它。
失效引用
当你改名或删除某个被编排器 profile 引用的 Skill，profile 的 skills.visible 列表仍然保留旧名。运行时找不到它，于是 agent 静默看不到（没有错误、没有阻断派遣）。
在编排器配置编辑器里，失效引用变灰，并带 tooltip 「该 Skill 未安装」。两次点击就能修：要么在 profile 里改名，要么重新加上这个 Skill。
这种「软失败」纪律是有意的。它意味着：缺失的 Skill 永远不会阻断 agent 派遣；增加 / 删除 Skill 不需要同步编辑 profile。
相关
- Skills 概览 —— 什么是 Skill、三种作用域
- 创作 Skill —— 写自己的
- 编排器集成 —— 把 Skill 挂到 profile 上
- Skill 扩展 API —— 从扩展编程式管理
- 补全预设助手 —— 派生
-orchestrator预设并给出打包 Skills 链接