插件与技能 (Plugins & Skills)

扩展 Agent 的能力、安装第三方扩展包、打包自定义工作流技能，并与模型上下文协议 (MCP) 服务端进行对接。

可扩展性模型 (The extensibility model)

Antigravity CLI 旨在提供无限的自定义。您可以通过安装名为插件 (Plugins) 的结构化包模块，或创建名为技能 (Skills) 的本地化 Markdown 蓝图，来增强共享的 Agent 功能体系。

这些自定义项允许 Agent 访问专用的专有命令、调用特定领域的子 Agent，并参考自定义的样式限制。

Antigravity 插件 (Antigravity plugins)

插件是具有命名空间的捆绑包，将自定义技能 (skills)、后台子 Agent (subagents)、Linting 规则、模型上下文协议 (MCP) 定义以及事件钩子 (hooks) 打包为一个单一的、可部署的资产。

插件文件系统结构

当您安装或导入插件时，CLI 会将捆绑包文件存放在您的全局配置路径中：

~/.gemini/antigravity-cli/plugins/<plugin_name>/

一个符合规范的插件包含以下布局：

~/.gemini/antigravity-cli/plugins/<plugin_name>/
├── plugin.json                 # 必需的包标记文件
├── mcp_config.json             # 可选的模型上下文协议服务端定义
├── hooks.json                  # 可选的工具前置/后置事件钩子
├── skills/                     # 可选的专用技能目录
├── agents/                     # 可选的子 Agent 定义模板
└── rules/                      # 可选的自定义代码库规则文件

通过 CLI 子命令管理插件

CLI 提供了 plugin（或复数 plugins）子命令管道来管理您的扩展：

• 列出已安装的插件：显示当前活跃的包及其已加载的组件。

  agy plugin list

• 安装本地或远程插件：将一个包目录存放并注册到您的本地配置文件中。

  agy plugin install /path/to/local/plugin

• 禁用/启用插件：暂停插件的工具而不删除其资产。

  agy plugin disable <plugin_name>
  agy plugin enable <plugin_name>

• 卸载插件：清除包目录并清理注册表。

  agy plugin uninstall <plugin_name>

Agent 技能包 (Agent skills)

技能包是声明性的、人类可读的 Markdown 文件，概述了针对特定工程任务的明确指令协议、脚本和目标资源。

一旦注册，技能包会自动在 TUI 中转换为斜杠命令，允许您手动调用（例如，输入 /refactor-ui）。

创建本地工作空间技能包

要部署随 Git 仓库一起保留的特定工作空间技能包：

1. 在项目根目录下创建一个名为 .agents/skills/ 的目录。
2. 在该目录下，起草一个带 .md 后缀的 Markdown 文件（如 format-tests.md）。
3. 定义技能包的 Frontmatter 元数据：

   ---
   name: format-tests
   description: Standardize and re-format Python unittest assertions
   ---

4. 在元数据下方，为 Agent 编写明确的指令。当您在此目录中运行 agy 时，该技能包会被编译，并且 /format-tests 会在提示框中可用。

共享全局技能包

要在您工作站的所有工作空间之间共享技能包，请将目标 Markdown 文件放入您的全局配置路径中：

~/.gemini/antigravity-cli/skills/

只要您在任何目录下启动 agy，该目录下的任何 Markdown 技能包都会被自动导入为全局斜杠命令。

管理钩子 (Managing hooks)

钩子 (Hooks) 在执行之前或之后拦截 Agent 的操作。它们对于运行自动化的预检或后置生成格式化（例如在写入文件后运行 prettier）非常有用。

钩子定义在插件的 hooks.json 中，或者配置在您的主 settings.json 文件中。您可以通过输入以下命令在 TUI 中检查所有已加载且活跃的钩子：

/hooks

模型上下文协议 (MCP) (Model Context Protocol)

模型上下文协议是一个开放标准，使基础模型能够安全地与本地 API、文件解析器和自定义开发工具进行对接。

Antigravity CLI 支持本地进程和远程主机 MCP 服务端配置。

访问 MCP 管理器

在提示面板中输入 /mcp 并按 Enter 即可打开交互式的“MCP 管理器浮层 (MCP Manager Overlay)”。该面板允许您：

• 查看活跃、已断开连接或正在加载的服务端的实时状态环。
• 手动重新加载服务端配置或检查连接日志。

全局与工作空间服务端配置

与传统的配置不同，Antigravity 将 MCP 定义分离到专用的、稀疏的配置文件中：

• 全局服务端配置：配置在 ~/.gemini/antigravity-cli/mcp_config.json 中。
• 工作空间本地配置：配置在您当前活跃的项目下的 .agents/mcp_config.json 中。

{
  "mcpServers": {
    "sqlite-explorer": {
      "command": "node",
      "args": [
        "/usr/local/bin/sqlite-mcp-server.js"
      ],
      "env": {
        "SQLITE_DB_PATH": "/var/data/app.db"
      }
    }
  }
}

[!WARNING] 远程连接模式 (Remote Connection Schema)：在声明远程基于 SSE 或 WebSocket 的 MCP 连接时，您必须定义 serverUrl 字段。不支持像 url 或 httpUrl 这样的旧字段。

下一步 (Next Steps)

了解如何从 Gemini CLI 迁移您现有的配置并排查连接异常：

• 从 Gemini CLI 迁移 (Migration from Gemini CLI)：快速迁移您遗留的扩展与配置转换。
• 疑难解答 (Troubleshooting)：解决终端钩子错误、锁定或网络故障。
• 权限与沙箱 (Permissions & Sandbox)：在您的自定义插件和 MCP 服务端周围配置安全隔离环。