跳转到内容
AggregaAggrega
选择语言: 简体中文
本页面由机器翻译。阅读英文原文。

Aggrega 技能

Aggrega 技能教 AI 助手安装和使用 Aggrega。它是一个名为 aggrega 的文件夹,其中包含一个采用开放 Agent Skills 格式的 SKILL.md 文件;许多助手会从自己的技能文件夹中读取这种格式,并在你的请求涉及 Aggrega 时加载它。

有两种方式可以把技能提供给助手。会安装插件的助手会将其作为 Aggrega 插件的一部分获得,该插件还会将助手连接到 Aggrega MCP 服务器,一步完成:参见安装插件。任何从文件夹读取技能的助手,都可以让 aggrega 二进制文件将技能写入该文件夹:参见仅安装技能。

安装插件

仓库 aggrega-ai/aggrega-skills 包含该技能,同时也是适用于以下助手的插件。安装插件会添加 Aggrega 技能,并将助手连接到 Aggrega MCP 服务器,之后助手会自行以 aggrega mcp 启动该服务器,因此对该助手而言,既不需要 aggrega skills install,也不需要连接 MCP 服务器中的步骤。

插件不会安装 aggrega 二进制文件。请先按安装二进制文件所述安装它,以便助手在启动服务器时能在 PATH 上找到 aggrega。

Claude Code

Terminal window
claude plugin install aggrega --marketplace aggrega-ai/aggrega-skills

在 Claude Code 内部,等效命令是 /plugin install aggrega --marketplace aggrega-ai/aggrega-skills。

Codex

Terminal window
codex plugin marketplace add aggrega-ai/aggrega-skills
codex plugin add aggrega@aggrega

第一条命令将该仓库添加为名为 aggrega 的插件市场;第二条命令从中安装 aggrega 插件。

GitHub Copilot

在 GitHub Copilot CLI 中:

Terminal window
copilot plugin marketplace add aggrega-ai/aggrega-skills
copilot plugin install aggrega@aggrega

带 GitHub Copilot 的 Visual Studio Code 会找到 GitHub Copilot CLI 安装的插件,并同样使用它们。要从 Visual Studio Code 本身安装该插件,请在命令面板中运行 Chat: Install Plugin from Source,并提供仓库地址 https://github.com/aggrega-ai/aggrega-skills。

Gemini CLI

Terminal window
gemini extensions install https://github.com/aggrega-ai/aggrega-skills

Gemini CLI 会将该插件安装为它的扩展之一。

Antigravity

Terminal window
agy plugin install https://github.com/aggrega-ai/aggrega-skills

Cursor

Cursor 从 ~/.cursor/plugins/local/ 下的文件夹加载插件。将仓库放到那里,然后在命令面板中运行 Developer: Reload Window:

Terminal window
git clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega

Kiro

Kiro 将该插件安装为一个 power。在 Powers 面板中,选择 Add Custom Power,然后选择 Import power from GitHub,输入仓库地址 https://github.com/aggrega-ai/aggrega-skills,再选择 Install。Kiro 会随该 power 一起启动和停止插件的 MCP 服务器。

OpenClaw

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills

OpenClaw 在从其未自行审查过的来源安装插件之前,会询问两次。它首先会停下来,要求你审查该来源,并使用 --force 重新运行命令;然后会通过 --accept-capabilities 征求你对插件所带来内容的同意——此处为技能和一个 MCP 服务器。审查过仓库之后,运行:

Terminal window
openclaw plugins install aggrega --marketplace aggrega-ai/aggrega-skills --force --accept-capabilities

--force 还会替换已安装的同名插件,因此如果你之前安装过名为 aggrega 的插件,请先检查 openclaw plugins list。

服务器工作的文件夹

Aggrega 的工具在工作区中工作,未指定工作区的调用会在服务器根据其启动所在文件夹找到的工作区中得到响应。有些助手会在插件自己的文件夹中启动插件的服务器,而不是在你的项目中——Codex 就是如此。技能会要求助手在项目中工作之前,先用 config-show 工具检查服务器在哪个工作区中响应;如果两者不同,则在每个接受该参数的调用中将项目的文件夹指定为 workspace_root——使用其完整路径,因为相对的 workspace_root 是以服务器当前响应所在的工作区为基准解析的。

仅安装技能

要在不使用插件的情况下安装技能,请使用 aggrega 二进制文件,它会写入内置于其中的副本。为你机器上的助手,在你的每个项目中安装它:

Terminal window
aggrega skills install --global

在你所在的项目中为某一个助手安装它,并指明该助手:

Terminal window
aggrega skills install --agent claude-code

列出可以为其安装的助手,以及每个助手读取的文件夹:

Terminal window
aggrega skills list

安装命令也可以在安装二进制文件时添加它:安装时添加助手技能给出了相应选项。以这种方式安装时,技能不附带服务器连接:请按连接 MCP 服务器所述将助手连接到服务器。

技能告诉助手的内容

技能告诉助手如何安装 Aggrega、如何将其连接到 aggrega mcp 服务器、如何开始一个工作区,以及如何运行编写 Aggrega 文件所述的编写循环——scaffold、validate、build。它不包含任何 schema 或实体契约的副本:对于每个结构性问题,它都让助手从二进制文件获取答案——服务器已连接时使用 MCP 工具,否则使用 aggrega 命令行——而事物的含义则查阅已发布的文档。

技能和 MCP 服务器承担不同的工作,助手同时拥有两者时效果最好。技能是助手读取的说明;服务器(由插件连接,或按连接 MCP 服务器进行连接)是助手调用的工具。既不安装插件、又不在 --agent 列表中的助手会跳过技能,但仍可通过服务器获得相同的工具和参考资料。

安装位置

插件将技能保存在助手存放其插件的文件夹中。aggrega skills install 则将其写入别处:不使用 --global 时,写入工作区根目录下该助手的项目技能文件夹,项目的技能就提交在那里;使用 --global 时,写入你主目录中该助手的按用户技能文件夹,助手在每个项目中都会读取该文件夹。使用 --global 且未指定 --agent 时,该命令会查找你机器上的助手,打印找到的每个助手以及是通过什么找到它的,并在终端中先询问再写入。aggrega skills 给出了每个助手的文件夹、每个助手是通过什么找到的,以及该命令拒绝覆盖的内容。

保持技能为最新

随插件附带的技能会随插件一起更新,更新方式即助手自身更新插件的方式;克隆到 Cursor 本地文件夹中的插件,通过在该文件夹中运行 git pull 进行更新,然后执行 Developer: Reload Window。插件连接的是你 PATH 上的 aggrega 二进制文件运行的服务器,因此工具和参考资料与你已安装的二进制文件保持一致。

技能也内置于 aggrega 二进制文件中,因此 aggrega skills install 写入的副本与你已安装的版本一致。升级 Aggrega 之后——安装程序命令会就地更新二进制文件——再次运行同一条 aggrega skills install 命令,将该副本更新到新版本。