Skills 与 Rules
将 MCP 连接到 LLM 智能体后,智能体就能直接调用 WEEGLOO API。但是,能调用 API 与按照 WEEGLOO 所设计的方式准确地使用这些 API 是两回事。例如,什么情况下该用 CMA、什么情况下该用 CDA,Content Type 的字段应该如何设计,为 Delivery Access Token 绑定哪些权限才安全,这些仅凭调用方法是无法知道的。
Skills 与 Rules 是填补这一鸿沟的两种指引。Skills 是讲解如何出色完成特定任务的指南,Rules 则是贯穿各项任务都要遵守的规则。安装工具(npx weegloo@latest)可以在连接 MCP 的同时把这两者一并安装。
Skills 与 Rules 的区别
两者都是提供给智能体的信息,这一点相同,但作用不同。
Skills 是以步骤和模式整理出如何执行某项特定任务的指南。每项任务对应一个,智能体在开始该任务时会读取并遵循相应的 Skill。例如 Content Type 设计、服务结构选择、Delivery Access Token 发放等任务各有一个 Skill。智能体由此遵循经过验证的方法,而不是依赖猜测。
Rules 是无论任务类型如何都必须始终遵守的规则。例如 WEEGLOO API 的基础地址、按页获取资源列表的方式、修改资源时必须一并发送版本信息等。智能体会在整个任务过程中将这些规则作为背景加以应用。
归纳起来,Skills 是“这项任务这样做”的按任务指引,Rules 是“无论做什么任务都要遵守这一点”的通用规则。
安装
Skills 与 Rules 由 MCP 安装工具一并安装。在终端中执行以下命令即可。
npx weegloo@latest执行后,工具会依次询问要连接的环境(智能体)和 Personal Access Token,并在连接 MCP 的同时将 Skills 和 Rules 安装到相应环境。安装过程及各环境的配置在 连接 中介绍。
使用 @latest 会始终安装最新版本。已经安装之后如何让它保持最新,在 保持最新状态 中介绍。
保持最新状态
Skills 与 Rules 并不是安装一次就结束的。每当 WEEGLOO 新增功能、推荐做法发生变化,这些指引也会随之更新。而安装在自己电脑上的内容是安装当时的副本,会一直停留在原处。
已安装的内容过时后,会出现两种情况。新增的 Skill 和 Rule 在已安装的内容里根本不存在,因此智能体不知道该如何处理那些功能。原有项目的内容有所变化时,智能体会照着旧的指引去做。无论哪一种,智能体都不是按照现在的 WEEGLOO,而是按照安装当时的 WEEGLOO 来工作。智能体给出的结果质量就取决于这一点,所以最好让 Skills 与 Rules 保持最新状态。
需要保持最新的,是安装在自己电脑上的 Skills 与 Rules。MCP 服务器没有需要另行更新的部分。
有新版本时,智能体会主动告知。智能体在开始 WEEGLOO 相关任务时会确认已安装的版本,如果已经是最新的就不显示任何内容。只有在有需要更新的内容时,才会显示如下提示以及要执行的命令。
该更新不会自动执行。它会重写已安装的文件,因此要在用户确认之后才执行。看到提示后,最好不要往后拖,就在那时执行命令。把提示中显示的命令原样在终端中执行即可。
--agent 和 --location 的位置会填入安装时选择的环境和位置,因此命令会随安装状态而不同。直接照用提示中显示的命令,填入的就是正确的值。
除了自己输入命令,也可以对智能体说“帮我更新 weegloo”。智能体已经知道要执行哪条命令,所以不必再去查找。
更新会保留什么、会改变什么
更新并不是从头重新安装一遍。它保留首次安装时所做的选择,只把内容更新到最新。
- 安装时对 Skills 与 Rules 所做的选择会原样保留。如果当时只安装了一部分,就维持那个状态。
- 上次安装之后新增的 Skills 与 Rules 会自动一并安装。安装时特意排除的项目,仍然保持排除状态。
- 在仓库中已被删除的项目,也会从自己的电脑上移除。
- 会停留在安装时选择的版本上。
- 不会改动 MCP 服务器的配置。因此更新时不需要 Personal Access Token。
如果手动删除了已安装的 Skill 或 Rule 文件,更新会把该文件重新装回来。想去掉某个项目时,不要删除文件,而是重新执行安装命令,在选择界面中取消它。
更新的内容从新的对话开始生效。智能体在开始对话时就已读取 Skills 与 Rules,因此正在进行的对话会继续使用之前的内容。
自行查看
Skills 与 Rules 存放在公开仓库中。如果想直接打开查看已安装的内容,或确认哪项任务有哪些指引,可以参考该仓库。
Skills 与 Rules 分别位于仓库 plugins/weegloo/ 下的 skills/ 和 rules/ 目录中。
- Skills 目录:plugins/weegloo/skills
- Rules 目录:plugins/weegloo/rules
不使用安装工具而是手动接入时,同样可以直接取用上述 latest 路径下的文件。
