Antigravity 智能体平台与实战指南 (Google Antigravity Guide)

在学习了大语言模型的基础原理、Transformer 架构、RAG 以及 AI Agent 的理论之后，很多初学者的下一个迫切问题是：

“在真实的工业级日常研发中，我们究竟应该如何使用顶尖的 AI 平台，让智能体真正替我们写代码、排查 Bug、甚至端到端交付项目？”

答案就是 Google Antigravity（简称 AGY）。

Antigravity 是 Google 打造的下一代 AI-First 智能体软件研发平台。它标志着软件工程从早期的“代码自动补全（Copilot）”时代，正式迈向了“完全自主的配对编程智能体（Autonomous Pair Programming Agent）”时代！

本文将为你提供一份从入门到精通的 Antigravity 核心实战指南。

---

1. 范式转移：从 Copilot 自动补全到自主 Agent

初学者首先需要理解 Antigravity 与传统 AI 辅助编程工具的本质区别：

flowchart LR
    subgraph Copilot ["第一代：代码自动补全 (Copilot 模式)"]
        direction TB
        C1["只看光标前后几行代码"] --> C2["被动单行/单函数代码续写"]
        C2 --> C3["局限: 看不到全局工程，不会跑命令，不知道报错，改错要人类动手"]
    end

    subgraph Antigravity ["下一代：自主智能体 (Antigravity Agent)"]
        direction TB
        A1["通读全局工程代码与 Git 仓库"] --> A2["自主拆解多步工作计划 (Planning)"]
        A2 --> A3["自主查阅文档、编写/修改跨文件代码"]
        A3 --> A4["主动在终端运行编译和单元测试"]
        A4 --> A5["捕获报错自主反思纠错，直至跑通测试交付！"]
    end

多终端形态支持

Antigravity 提供了适配不同工作流的多重形态： 1. Antigravity 2.0 桌面端（Desktop App）：基于 Electron 构建的独立完整操作平台，拥有沉浸式的画布与全套监控面板； 2. 命令行终端（agy CLI）：专为终端极客打造的极简 TUI 界面，直接在 Shell 中唤醒智能体； 3. IDE 深度集成：无缝融入开发者的主流编辑器，提供代码级行内透镜（Inline Code Lens）； 4. Python SDK：供企业开发者通过程序化接口编排多智能体集群与自定义工作流。

---

2. Antigravity 2.0 核心界面：主画布与五大辅助视窗

进入 Antigravity 2.0 桌面端，整个工作空间被清晰地划分为两大核心板块：中央聊天主画布（Chat Canvas） 与 右侧辅助视窗面板（Auxiliary Pane）。

flowchart TD
    subgraph UI ["Antigravity 2.0 空间全景布局"]
        direction LR
        Sidebar["左侧导航栏<br>• 对话管理<br>• 项目仓库切换<br>• 定时任务设置<br>• Skills/Rules 定制<br>• 全局/项目设置"]
        Canvas["中央聊天主画布 (Chat Canvas)<br>• 自然语言提问与下发需求<br>• 斜杠命令 (/plan, /goal...)<br>• @ 上下文精准引用<br>• 拖拽图片/文档等多模态附件"]
        Auxiliary["右侧辅助视窗面板 (Auxiliary Pane)<br>1. Subagents (子智能体状态)<br>2. Background Tasks (后台任务监控)<br>3. Artifacts (可视化结构化产物)<br>4. Files Changed (代码 Diff 审查)<br>5. Terminals (终端输出与控制台)"]

        Sidebar --> Canvas --> Auxiliary
    end

五大辅助视窗的职责：

• 1. Subagents（子智能体面板）：主 Agent 在处理大型任务时，会像技术主管一样并行召唤“调研专家”、“测试专家”等子智能体。此面板可实时查看各个子 Agent 的执行状态与独立思考日志；
• 2. Background Tasks（后台任务面板）：监控长时间运行的后台支持进程（如 Dev Server 开发服务器、文件变动监听、或定时 Cron 调度任务）；
• 3. Artifacts（产物视窗）：用于展示智能体生成的复杂结构化内容（例如：系统设计图、架构演进方案、甚至可以直接点击操作的 Generative UI 交互式小组件）；
• 4. Files Changed（代码变更对比视窗）：展示全量跨文件修改的 Git Diff 视窗，每一行绿色新增与红色删除一目了然，方便开发者安全 Review；
• 5. Terminals（终端控制台）：透明展示 Agent 在机器上执行的 Shell 命令与输出日志。

---

3. 高效生产力魔法：斜杠命令与 @ 精准上下文

在 Antigravity 中，输入斜杠 / 可以直接唤醒内置的高阶专家工作流（Slash Commands），极大提升研发效率：

斜杠命令	核心功能	适用典型场景
/plan	结构化计划模式	面对复杂需求或重构时，强制 Agent 先进行系统设计与任务拆解，生成交互式计划文档供你审批，确认后再动手编码。
/goal	终极目标模式	适合夜间长时自主探索（Overnight task），Agent 面对报错绝不轻言放弃，自主反思尝试多种方案，直到彻底攻克目标。
/grill-me	深度面试反问模式	当你的需求还比较模糊时，让 Agent 主动对你进行技术发问与方案权衡，帮助你补齐边界细节与架构选型。
/schedule	定时任务调度	设置单次倒计时唤醒，或设置标准 Cron 周期性自动化任务（如“每周五下午自动跑安全审计”）。
/boost	深度慢思考增强	开启高阶多视角与严密逻辑推理，适合疑难算法排错与安全合规审查。
/browser	浏览器自主探针	唤醒自动化浏览器引擎，深入复杂的动态 Web 页面抓取数据或进行端到端网页测试。
/teamwork-preview	多智能体团队协同	启动由多个自主角色（产品经理、前端开发、后端测试）组成的协同战队。

@ 上下文精准挂载机制

在输入框输入 @，可以精准将外部知识“链接”给 Agent： - @file / @folder：指定具体的文件或目录，Agent 无需全局盲搜，直奔目标核心； - @rules：强制引入特定的工程规范文件； - @mcp：手动指定调用某一个 MCP 工具扩展。

---

4. 终端安全机制：命令沙箱 (Terminal Sandbox)

由于 Antigravity 拥有在你的机器上执行 Shell 命令（run_command）的强大能力，安全防护是绝对的第一优先级。

Antigravity 独创了 双模态终端安全沙箱机制：

flowchart TD
    Command["Agent 产生终端执行指令 (例如: blaze build 或 npm test)"] --> SandboxCheck{"是否属于沙箱隔离范围？"}

    SandboxCheck -- 纯项目工作区内读写/编译 --> Sandbox["【标准沙箱模式】(BypassSandbox: false)<br>• 隔离文件系统 (仅限 Workspace 内部读写)<br>• 严禁随意发起未授权的外网网络请求<br>• 自动静默秒级执行，不打扰人类"]

    SandboxCheck -- 涉及 Git Push / 外网下载 / 修改系统配置 --> Bypass["【旁路授权模式】(BypassSandbox: true)<br>• 触发安全预警弹窗<br>• 必须等待人类用户显式点击'批准'后方可执行！"]

• 标准沙箱模式：默认情况下，Agent 可以在工作空间内自由读取、修改代码、运行单测，保障研发顺畅流利；
• 旁路授权模式：一旦命令涉及网络外联（例如推送代码到远程 GitLab、通过 npm/pip 在线安装依赖）或修改系统全局目录，系统会强制拦截并等待你亲手点击授权，彻底杜绝数据泄露或误删破坏。

---

5. 平台定制化体系：打造项目专属专家

为了让通用大模型成为精通你团队特有代码规范与内部架构的“老员工”，Antigravity 提供了三层高度可定制的扩展系统：

flowchart LR
    Custom["Antigravity 定制化三层体系"]
    Custom --> Rules["1. 规则约束 (Rules)<br>文件: GEMINI.md / AGENTS.md<br>声明编码风格、命名规范与技术禁忌"]
    Custom --> Skills["2. 技能拓展包 (Skills)<br>目录: skills/<name>/SKILL.md<br>渐进式披露复杂运维流程与专属 SOP"]
    Custom --> MCP["3. 模型上下文协议 (MCP)<br>配置: mcp_config.json<br>无缝对接企业内部数据库、Jira、Slack"]

5.1 Rules（规则系统）：立规矩

在项目根目录放置 GEMINI.md 或 AGENTS.md，写明你的工程准则。例如：

# 团队工程规范
- 所有 Python 函数必须包含完整的 Type Hint 类型标注；
- 严禁在循环内部发起数据库 SQL 查询；
- 每次修改代码后，必须自动运行 pytest 验证；
- 所有的 Markdown 文档标题不得包含任何 LaTeX 公式字符。

Agent 每次开始工作前，都会自动继承这些规则，彻底杜绝“写出的代码风格与团队格格不入”的问题。

5.2 Skills（技能包系统）：教新能力

当有一些复杂、多步骤的专业工作流（例如：“如何将老系统数据库平滑迁移到分布式集群”、“如何使用特定的内网发布平台发布应用”）时，可以编写一个专属 Skill。 - 渐进式披露（Progressive Disclosure）：日常闲聊时，Skill 不会挤占宝贵的上下文窗口；只有当任务命中了 Skill 的描述时，Agent 才会动态加载其内部的详细指令，极其节省 Token。

5.3 MCP（Model Context Protocol）：接工具

MCP 是由行业发起的开放通用工具协议。通过配置本地或远程的 MCP Server，Agent 可以瞬间解锁成百上千种外部系统能力： - 直接执行安全受控的只读 SQL 查询企业 PostgreSQL / MySQL 数据库； - 自动读取 GitHub / GitLab 的 Pull Request 与 Issue 列表； - 向团队 Slack / 飞书频道自动播发研发周报。

---

6. 端到端实战：使用 Antigravity 开发一个新特性

我们通过一个实际案例，直观展示使用 Antigravity 进行完整软件工程研发的标准高效范式：

sequenceDiagram
    autonumber
    actor Dev as 人类工程师
    participant AGY as Antigravity Agent
    participant Sandbox as 沙箱环境
    participant Git as GitLab 远程仓库

    Dev->>AGY: /plan "请为用户系统新增微信扫码登录功能"
    Note over AGY: 步骤 1: 需求拆解与架构设计<br>生成结构化实现方案 (Artifact)
    AGY-->>Dev: 呈现实现计划，请求评审确认
    Dev->>AGY: 点击 Proceed 批准计划

    Note over AGY: 步骤 2: 自主编写跨模块代码<br>修改 controller, service 与路由配置
    AGY->>Sandbox: 在沙箱中静默运行单元测试: pytest tests/test_auth.py
    Sandbox-->>AGY: 报错: Redis Token 校验超时
    Note over AGY: 步骤 3: 捕获报错并自纠错<br>定位到过期时间配置 Bug，重新修改代码
    AGY->>Sandbox: 再次运行测试: pytest tests/test_auth.py
    Sandbox-->>AGY: 测试全部通过 (PASS)!

    AGY-->>Dev: 弹出 Files Changed Diff 视窗，展示改动细节
    Dev->>AGY: "确认无误，请提交并推送到 main 分支"
    Note over AGY: 步骤 4: 触发旁路模式 (BypassSandbox)<br>请求外网网络操作权限
    AGY->>Dev: 弹出 Git Push 授权确认框
    Dev->>AGY: 点击允许
    AGY->>Git: git commit && git push origin main
    AGY-->>Dev: 交付完成，所有单测绿标，代码已入库！

通过这一套高度闭环、安全透明且自动化容错的机制，Antigravity 将人类工程师从繁琐、机械的搬砖劳动中彻底解放出来，让每一位开发者都能化身为运筹帷幄的“AI 研发舰队指挥官”！