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 相关任务时会确认已安装的版本,如果已经是最新的就不显示任何内容。只有在有需要更新的内容时,才会显示如下提示以及要执行的命令。

终端
📦 A Weegloo update is available (installed a1688fbfc979 → latest 6df28e82525f). To update, run the command below.

该更新不会自动执行。它会重写已安装的文件,因此要在用户确认之后才执行。看到提示后,最好不要往后拖,就在那时执行命令。把提示中显示的命令原样在终端中执行即可。

终端
npx weegloo@latest --agent claude --location global --update

--agent--location 的位置会填入安装时选择的环境和位置,因此命令会随安装状态而不同。直接照用提示中显示的命令,填入的就是正确的值。

除了自己输入命令,也可以对智能体说“帮我更新 weegloo”。智能体已经知道要执行哪条命令,所以不必再去查找。

更新会保留什么、会改变什么

更新并不是从头重新安装一遍。它保留首次安装时所做的选择,只把内容更新到最新。

  • 安装时对 Skills 与 Rules 所做的选择会原样保留。如果当时只安装了一部分,就维持那个状态。
  • 上次安装之后新增的 Skills 与 Rules 会自动一并安装。安装时特意排除的项目,仍然保持排除状态。
  • 在仓库中已被删除的项目,也会从自己的电脑上移除。
  • 会停留在安装时选择的版本上。
  • 不会改动 MCP 服务器的配置。因此更新时不需要 Personal Access Token

如果手动删除了已安装的 Skill 或 Rule 文件,更新会把该文件重新装回来。想去掉某个项目时,不要删除文件,而是重新执行安装命令,在选择界面中取消它。

更新的内容从新的对话开始生效。智能体在开始对话时就已读取 Skills 与 Rules,因此正在进行的对话会继续使用之前的内容。

自行查看

Skills 与 Rules 存放在公开仓库中。如果想直接打开查看已安装的内容,或确认哪项任务有哪些指引,可以参考该仓库。

Skills 与 Rules 分别位于仓库 plugins/weegloo/ 下的 skills/rules/ 目录中。

不使用安装工具而是手动接入时,同样可以直接取用上述 latest 路径下的文件。

下一步

  • 连接:介绍如何在各个环境(智能体)中安装 MCP 服务器、Skills 和 Rules。
  • MCP:介绍 MCP 服务器是如何构成的,以及服务器分组和文件上传服务器。