插件插件是命名空间捆绑包,允许您通过将技能、规则、MCP 服务器和挂钩分组到单个包中来扩展 Antigravity 的功能。
目录结构如果您想创建自己的插件或检查现有插件,它们遵循特定的目录结构。插件是一个包含 plugin.json 文件和不同自定义类型的可选子目录的目录:
plugins/<plugin-name>/
├── plugin.json # Required marker file
├── mcp_config.json # Optional MCP server definitions
├── hooks.json # Optional hooks definition
├── skills/ # Optional skills
│└── <skill-name>/
│└── SKILL.md
└── rules/ # Optional rules
└── <rule-name>.md
清单文件 ( plugin.json )
每个插件的根目录下都必须有一个 plugin.json 文件。该文件将该目录标识为插件。
{
"name": "my-custom-plugin"
}
name 字段是可选的,如果省略,则默认为目录名称。
支持的组件插件可以包含以下组件:
- 技能:位于
skills/子目录中。每个技能必须有一个SKILL.md文件,其中包含代理的说明。 - 规则:位于
rules/子目录中。这些是降价文件,定义代理行为的约束或指南。 - MCP 服务器:通过插件根目录下的
mcp_config.json配置。这允许您将 Antigravity 连接到外部工具和服务。 - 挂钩:通过插件根目录下的
hooks.json配置。这些允许您在发生特定事件时运行脚本或命令。
如何添加插件有两种方法可以向 Antigravity 添加插件:
1. 使用捆绑插件(使用 Google 构建)
Antigravity 附带了 Google 创建的各种捆绑插件。您可以直接从用户界面浏览并添加这些插件:
- 导航到 自定义 页面。
- 有关可用的 Google 构建插件的更多详细信息,请参阅 使用 Google 页面构建。
2. 手动添加插件您还可以通过将插件文件夹放置在指定的插件位置之一来添加自定义插件。 Antigravity 会自动扫描这些目录以发现并加载您的自定义内容:
- 工作区级别:将插件文件夹放置在打开的工作区根目录下的
.agents/plugins/或_agents/plugins/目录中。这使得该插件仅在该特定工作区中工作时可用。 - 全局级别:将您的插件文件夹放在用户主目录的
~/.gemini/config/plugins/内。这使得该插件在所有工作区中都处于活动状态。