技能库
浏览、筛选、启用技能，并把普通技能加入工作台。
技能（Skill）是智能体的专业能力模块：一份 SKILL.md 说明书（可附脚本），告诉它按什么步骤、用什么口径完成某类任务。技能库用来浏览、筛选、启用 / 禁用、置顶、导出与删除。写成业务应用的技能会出现在 工作台 卡片里。
对话中以 # 引用技能后，该技能说明会进入本次任务。本页不能在线新建技能，安装方式见下文「安装与使用」。
技能库：搜索、仅看业务应用、分类，以及技能卡片
一、列表与筛选
| 区域 | 说明 |
|---|---|
| 搜索 | 按名称、说明、标题、分类过滤 |
| 仅看业务应用 | 只显示已加入工作台的技能。再点一次恢复全部，并清除分类筛选 |
| 刷新 | 重新载入列表 |
| 问号 | 安装说明。本页不能在线创建 |
| 分类 | 全部 及各分类。未填写分类的归入 通用 |
技能以卡片列出。每张卡片含图标、名称和简介。名称旁可能有 业务、置顶、原子（通常由其他技能调用，不单独进入工作台）、扩展（来自扩展包或其它路径，不能加入业务应用）。带计费标记的显示 ¥。说明书无法调用时显示 异常。
卡片底部标签是分类、版本（有版本时）和作用范围：全局（用户技能目录，各工作目录都能用）、项目（只在当前工作目录）、路径（其它位置）。
部分技能无法读取时，工具栏会出现诊断入口。
二、卡片上的操作
单击卡片进入该技能的详情页。启用按钮和右侧 ⋮ 不会进入详情。
| 操作 | 说明 |
|---|---|
| 已启用 / 启用 | 已启用时带对勾，再点变为 启用（即停用）。停用不删除文件。提示「技能已启用」或「技能已禁用」 |
| 编辑技能 | 打开 SKILL.md 的预览与编辑（见第四节） |
| 导出 ZIP | 导出当前技能包，成功时提示「已导出 …」 |
| 置顶技能 / 取消置顶 | 仅 业务 卡片有。置顶后工作台卡片靠前，提示「已置顶」或「已取消置顶」 |
| 删除技能 | 红色。再点一次菜单里的 「再次点击确认删除」 才会删除 |
三、技能详情
单击卡片打开详情页。左上是 返回技能库，右上是技能标识（目录名，如 vl-docs-to-md）。
技能详情：简介、安装信息，以及业务应用配置。原子技能会标成「不适用」
标题下的标签包括 已启用 或 已禁用、分类、作用范围，以及卡片上已有的 原子、扩展、¥。说明书可以调用时还有 可用；有问题则是 异常。
能变成工作台卡片的技能，标题右侧是 加入业务应用 或 移出业务应用（再点 确认移出）。原子技能和扩展包没有这两个按钮，改由下方配置区说明原因。
| 区块 | 内容 |
|---|---|
| 技能简介 | 技能能力与适用场景；没有则显示「暂无描述」 |
| 启用状态 | 开关。文案为「已启用，Agent 可调用」或「已停用，Agent 不会调用」 |
| 安装路径 | 可点击复制；旁侧可打开所在位置，以及 查看 / 编辑 SKILL.md |
| 更新日期 | 技能文件最近更新日期（有记录时才显示） |
| 依赖技能 / 工作目录 | 业务配置里写了才会出现 |
说明书不合规时，页顶提示 「无法调用：…」，并说明须在 SKILL.md 里写上 description，且 name 与目录名一致。这时 加入业务应用 不可点。
四、查看 / 编辑 SKILL.md
从卡片菜单的 编辑技能，或详情中的 查看 / 编辑 SKILL.md 打开。可在 预览 与 编辑 之间切换，并可 导出 ZIP、打开技能所在位置。预览只显示正文，文件开头的配置头不出现在预览中。
预览模式：查看技能说明书；可切到编辑直接改 Markdown
改过之后标题旁会出现 「● 已修改」，可 撤销 或 保存（提示「SKILL.md 已保存」）。未保存就关闭，会问 「有未保存修改，确定关闭？」，可选 放弃并关闭 或 继续编辑。改完后建议新开一次对话再验证。
五、加入业务应用
详情最下方是 业务应用配置，旁注 「写入 conf.json 后出现在业务工作台」。右侧状态说明这只技能能不能变成工作台卡片。适合的会展开表单；不适合的只留一段提示，没有表单。
| 状态 | 页面上看到 |
|---|---|
| 不适用（原子技能） | 「原子技能一般由其他技能调用，只在技能库展示，不进入业务工作台。」带计费标记时句末还有「（计费技能）」。上图就是这种 |
| 不适用（扩展包或其它路径） | 「扩展包或其它路径下的技能会出现在技能库中，但不能加入业务应用。只有 agent/skills 目录下的技能可以设为业务应用。」 |
| 未设为业务应用 | 「尚未设为业务应用」。说明设好后可以配置工作台卡片的标题、说明、分类、关联系统和启动提示。点 加入业务应用 展开下面的表单 |
| 已是业务应用 | 表单直接可改。标题右侧是 移出业务应用 |
点 加入业务应用 后展开表单。右上角仍是 未设为业务应用，填完点右下角的 加入业务应用；取消 收起表单。
尚未设为业务应用：填写标题、说明和归类后加入工作台
| 字段 | 说明 |
|---|---|
| 标题 | 工作台卡片标题，最多 32 字。左侧可更换图标 |
| 说明 | 展示在工作台卡片上，最多 200 字 |
| 分类 | 2～4 个字，出现在技能库分类标签里 |
| 版本 | 如 1.0.0，可留空 |
| 关联系统 | 出现在工作台的 业务系统 筛选里，可留空 |
| 置顶 | 开关。打开后工作台卡片靠前 |
| 启动提示 | 启动时的参数提示，可留空 |
首次保存按钮为 「加入业务应用」（提示「已设为业务应用」）。已有配置时，改过才出现 保存（提示「业务配置已保存」）和 还原。标题、说明、分类没填会提示「请填写标题、说明和分类」；分类字数不对会提示「分类请填写 2～4 个字」。
从业务应用移出（或页顶的 移出业务应用）会先变成 确认移出，并说明将删除 conf.json、工作台不再显示。确认后提示「已从业务应用移出」。技能本身仍留在技能库，对话里仍可用 # 引用。
六、安装与使用
| 场景 | 做法 |
|---|---|
| 安装技能 | 将含 SKILL.md 的 .zip 拖入主窗口或本页（一层目录）；或将技能目录放入全局 / 项目技能目录 |
| 加入业务应用 | 详情里填写业务配置并保存，之后出现在 工作台 |
| 对话中引用 | 输入卡片点 选择技能（或输入 #）；旁侧 「管理」 跳转到本页 |
| 从工作台启动 | 已是业务应用的技能，在工作台点卡片启动。工作台里点标题或书本图标，只读查看说明，不能在那里改 |
与工作台的关系
工作台只展示可启动的业务卡片；技能库是完整的安装与管理中心（含未上工作台的技能）。原子技能多由其他技能编排调用，一般只在技能库里。详情若提示无法调用，请检查 SKILL.md 含说明，且名称与目录名一致。
七、技能 / 长期记忆 / MCP 怎么选
技能停用后不会删除安装文件；删除才会从库中移除。自研技能包须含 SKILL.md，拖入规则见 拖放安装与导入。