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

借助 AI 助手设置 Aggrega

能够在你的机器上运行命令的 AI 助手——终端或编辑器中的编码智能体——可以为你设置 Aggrega:安装 aggrega 二进制文件,为自身添加 Aggrega 技能,并将自身连接到 Aggrega MCP 服务器。会安装插件的助手通过安装 Aggrega 插件一步完成后两项;其他助手则依次添加技能、连接服务器。将下面的提示词粘贴给它,它就会逐步完成这些操作;提示词会要求它在安装任何东西之前先征得你的同意。

完成之后,助手有两种方式使用 Aggrega。技能是一个包含 SKILL.md 文件的文件夹,当你的请求涉及 Aggrega 时助手会加载它:它告诉助手编写循环如何运行,并要求助手关于 schema 或文件的每个答案都从二进制文件获取,而不是凭记忆。MCP 服务器 aggrega mcp 为助手提供 Aggrega 的工具——scaffold、validate、build 等——以及这些工具所依据的参考资料。Aggrega 技能介绍该技能和插件,连接 MCP 服务器介绍该服务器,你的助手可以用 Aggrega 做什么介绍助手通过该服务器能使用的内容。

设置完成后,入门、导入下的每个演练,以及每个使用 Aggrega 构建的可运行示例的页面,都会在命令旁边以可粘贴到助手中的提示词形式给出它们所讲授的任务。

提示词

请为我设置 Aggrega,一次一步,并告诉我你在每一步运行了什么。
1. 运行 `aggrega version`。如果找不到该命令,请先询问我再安装 Aggrega,然后使用官方安装程序为我的用户安装它:在 Linux 或 macOS 上运行 `curl -fsSL https://aggrega.ai/install.sh | sh`,在 Windows 的 PowerShell 中运行 `irm https://aggrega.ai/install.ps1 | iex`。再次运行 `aggrega version`。如果安装程序打印了一行需要添加到我的 `PATH` 中的内容,请把它展示给我。
2. 如果 `https://aggrega.ai/docs/ai-assistants/skill/` 给出了为你安装 Aggrega 插件的方法,请在安装前先询问我,然后按该方法安装;如果这是需要我在你的界面中执行的步骤,请告诉我该怎么做。该插件会添加 Aggrega 技能,并将你连接到 Aggrega MCP 服务器。否则,运行 `aggrega skills install --help`,在它打印的列表中找到你自己的标识符。询问我希望将技能安装在本项目中还是所有项目中,然后运行 `aggrega skills install --agent <your identifier>`,如果是所有项目则加上 `--global`。如果你不在列表中,请跳过技能的安装并告知我。
3. 如果你已安装插件,你就已经连接到 Aggrega MCP 服务器。否则,按照你添加 MCP 服务器的方式,将自身连接到 Aggrega MCP 服务器(即命令 `aggrega mcp`),具体方法见 `https://aggrega.ai/docs/ai-assistants/mcp-server/` 中针对你的说明。如果需要重启或重新加载才能加载插件或服务器,请告诉我该怎么做。
4. 连接后,不带参数调用 `describe-capabilities` 工具,并总结它列出的内容。

该提示词在文档发布的每种语言中都相同:只有其中的句子被翻译,其中的每个命令、标志、地址和工具名称都保持原样,因此无论你从哪种语言复制,助手读到的指令都相同。

安装程序会下载最新版本,根据该版本发布的 SHA-256 摘要进行校验,并仅为你的用户安装,无需管理员权限;安装二进制文件说明了它的具体操作,以及如何改为手动安装。

不同助手之间的差异

提示词中有三部分取决于助手:如果助手会安装插件,则是它安装 Aggrega 插件的方式;否则,是安装技能时它传给 --agent 的标识符,以及它添加服务器的方式。助手会根据提示词自行确定这些内容,但如果你知道,也可以直接写进提示词。

助手安装插件不使用插件安装技能
Claude Codeclaude plugin install aggrega --marketplace aggrega-ai/aggrega-skillsaggrega skills install --agent claude-code
Codexcodex plugin marketplace add aggrega-ai/aggrega-skills,然后 codex plugin add aggrega@aggregaaggrega skills install --agent codex
GitHub Copilot CLIcopilot plugin marketplace add aggrega-ai/aggrega-skills,然后 copilot plugin install aggrega@aggregaaggrega skills install --agent github-copilot
Gemini CLIgemini extensions install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent gemini-cli
Antigravityagy plugin install https://github.com/aggrega-ai/aggrega-skillsaggrega skills install --agent antigravity,对于 Antigravity CLI 则为 --agent antigravity-cli
Cursorgit clone https://github.com/aggrega-ai/aggrega-skills ~/.cursor/plugins/local/aggrega,然后执行 Developer: Reload Windowaggrega skills install --agent cursor

带 GitHub Copilot 的 Visual Studio Code、Kiro 和 OpenClaw 也会安装该插件;安装插件给出了每个助手的安装方式,以及 OpenClaw 在安装前会询问什么。--agent 接受的标识符以及每个标识符写入的文件夹,列在 aggrega skills 中,也可由 aggrega skills install --help 打印出来。每个助手添加服务器的方式——使用它自己的命令,或在其设置或服务器列表文件中添加条目——在连接 MCP 服务器中按客户端逐一说明。

当提示词的某部分不适用时

  • 安装插件的助手会跳过连接服务器:插件已经连接了它。插件不会安装二进制文件,因此第 1 步仍然适用。如果助手在你的项目之外启动插件的服务器——Codex 会在插件自己的文件夹中启动它——技能会要求助手向服务器指明你项目的文件夹,如服务器工作的文件夹所述。
  • 既不安装插件、又不在 --agent 列表中的助手会跳过安装技能。连接之后,它仍可通过 MCP 服务器使用 Aggrega 的工具,并且服务器会在它连接时向它提供服务器自己的指导。
  • 无法运行命令的助手——无法访问你终端的聊天应用——无法执行该提示词。请按照安装中的说明安装二进制文件,并按照连接 MCP 服务器中的说明自行连接该应用。关于 Claude Desktop,请参阅下文的 Claude Desktop。
  • 由他人为你运行、通过 HTTPS 访问的服务器既不需要二进制文件,也不需要插件或技能。请改为将地址提供给助手的客户端,如通过 HTTPS 访问的服务器所述。

Claude Desktop

Claude Desktop 通过每个版本附带的扩展包连接到 Aggrega,该扩展包会启动你计算机上安装的 aggrega。请在你的计算机上自行完成这两项设置:

  1. 在 Windows 上,可在 PowerShell 中使用 irm https://aggrega.ai/install.ps1 | iex 安装 aggrega;在 macOS 或 Linux 上,可在终端中使用 curl -fsSL https://aggrega.ai/install.sh | sh 安装。安装二进制文件介绍了安装程序的作用。
  2. 安装扩展包,设置其 Workspace folder,然后重启 Claude Desktop,具体如“连接 MCP 服务器”页面中的 Claude Desktop 所述。

Claude Desktop 会话可以在云容器中而不是在你的计算机上运行命令,因此上面的提示词粘贴到该会话中后,作用于容器。在容器中,一旦容器的网络策略允许 aggrega.ai,就可以从会话的 shell 安装并运行 aggrega——由组织所有者在组织的网络访问设置中允许。Aggrega MCP 服务器在那里不会被连接:Claude Desktop 只从其扩展设置中添加本地服务器,而该扩展启动的是你计算机上的 aggrega,而不是容器中的那个。

aggrega skills install 没有 Claude Desktop 条目,因此 Claude Desktop 会话会跳过安装技能。扩展安装后,它通过 MCP 服务器使用 Aggrega 的工具,并且服务器会在它连接时向它提供服务器自己的指导。