从 Gemini CLI 迁移 (Migrating from Gemini CLI)

如果您是现有的 Gemini CLI 用户，并希望将您的工作流迁移到 Antigravity CLI，那么您来对地方了。以下指南将帮助您快速熟悉并在 Antigravity CLI 中开始运行。

[!NOTE] 简而言之 (TL;DR)：Antigravity CLI 支持 Gemini CLI 的绝大多数功能。尽管不能达到 100% 的功能对等，但定义工作流的核心功能（如 Gemini CLI 扩展/Antigravity 插件、Agent 技能包、MCP 服务端、钩子以及子 Agent）在 Antigravity CLI 中均受支持。 在首次启动 Antigravity CLI 时，您应该会看到 迁移选项 (Migration Options)，可以在其中选择将现有的 Gemini CLI 扩展迁移为对等的 Antigravity 插件。

[!NOTE] 注意：某些 Gemini CLI 扩展无法 1:1 地迁移为 Antigravity 插件，因为当前尚不支持某些组件（例如自定义主题）。 对于绝大多数用户来说，现在就可以直接开始使用 Antigravity CLI，并继续使用您在 Gemini CLI 中喜爱的那些工作流。Antigravity CLI 会加载与 Gemini CLI 相同的上下文文件和全局 Agent 技能包。

如果您发现某些功能没有按照您所期望的方式运行，请参考下方的具体细节。

Gemini CLI 扩展 → Antigravity 插件 (Gemini CLI Extensions → Antigravity Plugins)

自 Gemini CLI 推出“扩展”（一种通过捆绑和共享功能来扩展 CLI 的方式）以来，业界已将该术语标准化为“插件 (plugins)”。Antigravity CLI 中完全支持 Antigravity 插件。

在首次启动 Antigravity CLI 时，应该会提示用户将其扩展自动迁移到插件。您也可以在终端执行明确的命令来进行手动迁移：

agy plugin import gemini

运行 agy plugin import gemini 命令将搜索每个本地安装的扩展并将其转换为 Antigravity 插件：

  [ok]    conductor
          - skills      : skipped (not found)
          - agents      : skipped (not found)
          ✔ commands    : 6 processed (converted to skills)
          - mcpServers  : skipped (not found)
          - hooks       : skipped (not found)
  [ok]    google-workspace
          ✔ skills      : 6 processed
          - agents      : skipped (not found)
          ✔ commands    : 4 processed (converted to skills)
          ✔ mcpServers  : 1 processed
          - hooks       : skipped (not found)

上下文文件/规则 (Context Files / Rules)

Antigravity CLI 支持与 Gemini CLI 相同的上下文文件：

• 工作空间上下文：读取您当前活跃的工作空间目录下的 GEMINI.md 和 AGENTS.md。
• 全局上下文：自动加载并强制执行位于 ~/.gemini/GEMINI.md 的全局限制。

Agent 技能包 (Agent Skills)

Agent 技能包在 Antigravity CLI 中的工作方式与在 Gemini CLI 中完全相同。它们可以通过相同的 /skills 命令进行管理，同时它们也会被转换为斜杠命令，允许您手动调用。

Gemini CLI 的全局技能包位于 ~/.gemini/skills/ 下，并且可以跨所有工作空间与 Antigravity CLI 共享。全局技能包不需要任何额外操作，它们会被自动加载。

Antigravity CLI 的工作空间特定技能包存储在 .agents/skills 中。这意味着如果您在特定项目的 .gemini/skills 文件夹下拥有项目/工作空间级别的技能包，则需要将它们移动到 .agents/skills。

属性	Gemini CLI	Antigravity CLI
位置	全局：~/.gemini/skills/ 工作空间：.gemini/skills/ 或 .agents/skills/	全局：~/.gemini/antigravity-cli/skills/ 工作空间：.agents/skills/
管理	/skills	/skills
行为	技能包转为斜杠命令	技能包转为斜杠命令

[!NOTE] 注意：Antigravity CLI 当前没有在终端管理 Agent 技能包的 gemini skills 对等命令。您可以手动创建自己的技能包文件，或者使用 npx skills install。

MCP 服务端 (MCP Servers)

Antigravity CLI 支持本地和远程的 MCP 服务端，并提供相同的 /mcp 命令来管理它们。与 Gemini CLI 的主要区别是定义 mcpServers 的文件位置。

Antigravity 和 Antigravity CLI 将 MCP 服务端配置存储在独立的 mcp_config.json 文件中，而 Gemini CLI 则将它们内嵌在 settings.json 中。

[!WARNING] 重要提示：对于远程 MCP 服务端，Antigravity CLI 使用 serverUrl 字段，而不是 url（或已废弃的 httpUrl）。

属性	Gemini CLI	Antigravity CLI
位置	全局：~/.gemini/settings.json 工作空间：.gemini/settings.json	全局：~/.gemini/antigravity-cli/mcp_config.json 工作空间：.agents/mcp_config.json
管理	/mcp	/mcp