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

执行后，工具会依次询问要连接的环境（IDE）和 Personal Access Token，并在连接 MCP 的同时将 Skills 和 Rules 安装到相应环境。MCP 连接过程及各环境的配置在 MCP 中介绍。

使用 @latest 会始终安装最新版本。由于 WEEGLOO API 与推荐模式会持续更新，建议定期重新执行此命令，使 Skills 与 Rules 保持为最新状态。

自行查看

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

• 仓库：github.com/weeglooapi/weegloo-mcp-plugin

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

• Skills 目录：plugins/weegloo/skills
• Rules 目录：plugins/weegloo/rules

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

后续操作

• MCP：介绍 MCP 连接方法与各环境的配置。Skills 与 Rules 也会在此连接过程中一并安装。