Skip to content

安装和更新业务 Skill

同事已经把一套业务操作整理成了 Skill,你不需要再把规则一遍遍讲给 Agent。把 Skill 安装到本机后,直接说出业务需求,Agent 就会按这套规则执行。

这篇文档带你完成三件事:找到自己有权限使用的 Skill、安装到本机、在 Skill 更新后同步最新版本。

TIP

先看懂 Skill 权限

个人版(personal):只有发布者本人和企业管理员能看到。你看不到其他同事的个人版,也不能安装。 公司版(company):提交后需要管理员审核。审核通过后,公司成员才能查看和安装。 同名版本:同一个 skillCode 同时有个人版和公司版时,发布者本人使用个人版,其他成员使用审核通过的公司版。

查看你能使用的 Skill

在已经切换到目标应用的目录中执行:

bash
lovrabet skill list

这条命令只查看云端列表,不会安装文件。结果中的 personal 是你自己的个人版,company 是当前公司内已经审核通过、且你有权限使用的公司版。

先在列表中找到要使用的 Skill,记下它的 skillCode。后面的安装、更新都用这个编码。

安装一个 Skill

第一次使用时,建议先安装目标 Skill,不要一次安装全部内容:

bash
lovrabet skill install --code <skillCode>

看到安装成功提示后,继续下一步检查。安装只会把当前应用下、你有权限看到的版本同步到本机,不会修改云端 Skill。

如果需要一次安装当前应用下所有可见的业务 Skill,再执行:

bash
lovrabet skill install

检查 Skill 是否已经装好

执行:

bash
lovrabet skill list --local

这次查看的是本机列表。结果中出现目标 skillCode,说明安装完成,Agent 已经可以发现这个 Skill。

如果同一个 skillCode 同时存在个人版和公司版,两份文件都会保留,但实际生效的是个人版。这个规则可以避免你正在调试的个人版本被公司版本覆盖。

用一句业务需求验证 Skill

回到 Agent 对话,直接发送这个 Skill 面向用户的典型需求。不要在消息里写 Skill 名称,也不用教 Agent 逐条执行 CLI 命令。

例如,一个用于检查发票的 Skill,可以直接发送:检查一下这张发票

Agent 能识别需求、加载对应 Skill,并按 Skill 里的步骤返回结果,就说明安装成功。

在 Skills 页面确认 Skill 已经可以使用

同步 Skill 的最新版本

同事通知公司版已经更新,或者你刚刚重新发布了个人版时,再执行一次安装命令:

bash
lovrabet skill install --code <skillCode>

CLI 会把这个 Skill 的最新可用版本同步到本机,并清理该编码下已经失效的链接或缓存。

需要刷新当前应用下的全部业务 Skill 时,执行:

bash
lovrabet skill install

完整安装还会清理当前应用下已经从云端删除的 Skill。更新后,再执行 lovrabet skill list --local 检查版本。

遇到问题时这样检查

**同事能看到个人版,我为什么看不到?**个人版只对发布者本人和企业管理员可见。同事需要把 Skill 提交为公司版,管理员审核通过后你才能安装。

**公司版已经提交,我为什么还看不到?**提交成功不等于已经生效。先确认管理员已经审核通过,再检查自己是否切换到了发布这个 Skill 的应用。

**安装了公司版,Agent 却还在使用我自己的内容?**先运行 lovrabet skill list --local --scope all。如果同一个 skillCode 还有个人版,个人版会优先生效。

**列表里没有 Lovrabet CLI 的内置使用手册?**内置 Skill 和业务 Skill 分开管理。安装或刷新内置 Skill 请执行:

bash
lovrabet cli-skill install

内置 Skill 不会出现在 lovrabet skill list 中,也不能通过 lovrabet skill push 发布。

基于飞书知识库同步生成,内容以飞书源文档为准