技能、MCP 与插件

#开始前

名词	是什么	例子
技能（Skill）	写给 Agent 的操作说明	前端设计规范、周报格式
MCP	连接外部工具或数据的服务	查询数据库、读取工单
插件	Agent 生态中的扩展包	Claude Code、Codex 已安装的插件

先完成 Agent 安装与登录，再为它启用所需能力。

#管理已有技能

打开 设置 → 技能管理，顶部选择 Skill。

① 顶部切换 Skill、MCP 和插件。② 左栏搜索或按标签筛选技能，圆点表示各 Agent 的启用状态；点击技能后，右栏显示说明、标签和逐个 Agent 的开关。③ 导入已有 可把 Agent 目录里未纳管的技能收编进技能库。

技能列表直接显示每个技能的标签，过长的标签可悬停查看全文。

未选择技能时，右栏显示各 Agent 已安装的技能数量（含未纳管项）。点击某个已安装的 Agent，左栏只显示它目录中的技能，可以和搜索、标签筛选组合使用，再次点击取消；项目技能和插件内置技能不在这个筛选范围内。窄窗口会改为单栏，查看详情后可返回列表。

#发现并安装技能

1. 在 Skill 左栏切换到 发现。

   

2. 可以查看热门技能、搜索 skills.sh，或输入公开 GitHub 仓库地址、owner/repo 扫描仓库。热门列表是标有日期的快照，不是实时榜单。

3. 选中候选技能，在右栏阅读 SKILL.md、确认来源、文件数量与大小，再安装。

4. 可只安装到技能库，也可同时为已经安装且启用的受支持 Agent 开启。安装成功后可跳回 我的技能 查看。

同名技能替换需要确认，并保留旧主副本备份。某个 Agent 启用失败不会撤销已经安装的技能，按页面提示处理即可。

#检查更新

在技能管理中手动检查更新，可以查看有来源记录的 GitHub 技能或飞书官方技能是否变化，并打开来源核对。更新提示不会自动覆盖本地内容。

“未检查”与“检查失败”不代表已经是最新版。没有来源、固定引用或无法比较的项目会单独说明原因。

#MCP 与插件

MCP 同样采用左侧列表、右侧详情，可以查看启动命令或 HTTP 地址，并为 Agent 分别启用。新增 MCP 后，Caravel 会写入对应 Agent 的配置；详情只显示环境变量或请求头名称，不展示其值。

插件由各 Agent 自己安装，Caravel 提供统一查看和开关。Codex 插件页另有配置守护：外部工具整体覆盖配置导致已记录的插件、市场或 MCP 配置丢失时，可以自动恢复；页面可查看守护数量、最近恢复，以及仍有缓存的可恢复插件，也可关闭自动恢复。

只删除插件条目而保留市场配置会被视为主动卸载，不会强行恢复。守护记录建立前已经丢失且没有可恢复来源的插件，不能凭空找回。

#完成后你会看到

技能详情中对应 Agent 的开关已启用。新建任务或继续对话时，输入 / 后选择 技能 或 MCP；技能依赖的 MCP 会一并带上。这里只配置可用能力，不会立即启动任务。