antigravity-agent-manager

用途

Antigravity Agent Manager 是一份操作手册（playbook），用于编排多智能体系统：将独立的 Antigravity 2.0 Agent Manager（白色图标）与 Antigravity IDE（黑色图标）并行使用，在同一个代码库上同时指挥多个 AI 智能体处理前端和后端项目。

自 2.0 版起，Google 将 Agent Manager 从主 IDE 界面中解耦，移除了“Open Agent Manager”按钮。本技能说明如何并行安装、配置和操作这两套环境。

适用时机

需要协调多个前端、后端或 QA 智能体同时在同一代码库上工作时。
搭建双窗口工作区（Antigravity IDE + Antigravity 2.0 Agent Manager）时。
需要解决冲突，或面对提到已集成“Open Agent Manager”按钮的过时教程步骤时。

主要能力与使用方式

步骤 1：并行安装

保留当前 Antigravity IDE：不要卸载经典 IDE（黑色图标）。
下载 Antigravity 2.0：从 Antigravity 官方下载页面获取独立 Agent Manager 应用。
安装：运行安装程序，它会与现有 IDE 并存安装而不覆盖。此后应同时拥有：
- Antigravity IDE（黑色图标）：代码编辑器与手动开发工作区。
- Antigravity 2.0（白色图标）：多智能体编排仪表盘。

步骤 2：双工作区设置

同时打开 Antigravity IDE 与 Antigravity 2.0 两个应用。
在两个应用中加载同一个项目目录（例如 C:/Users/erwinpzocikk/Dev/GroupProjects/intIntercatedraAdmin）。
在 Agent Manager（白色图标）中配置智能体池，分配专长角色（如 frontend-agent、backend-agent、qa-validator）。

步骤 3：协调智能体执行

在 Agent Manager 中定义任务范围。为防止目录冲突和竞态条件：
- 将 backend-agent 分配到服务器目录（如 /server 或 /api）。
- 将 frontend-agent 分配到前端目录（如 /client 或 /src）。
并行运行智能体。
使用 Antigravity IDE（黑色图标）实时监控文件变更、审查差异并执行手动调整。

示例 1：在多智能体项目中定义独立范围

在配置 Agent Manager 仪表盘时，在提示词中指定目标文件或目录，避免智能体碰撞：

后端智能体任务提示词：

Role: Backend Developer Agent Workspace Target: /server Task: Add a new POST /api/v1/students endpoint in server/routes/students.js and update database/models/student.js. Do not edit files outside the /server directory.

前端智能体任务提示词：

Role: Frontend UI Agent Workspace Target: /client Task: Build the student registration form under client/components/StudentForm.jsx. Consume the /api/v1/students endpoint. Do not edit files outside the /client directory.

示例 2：通过 Git 同步变更

由于智能体并行编写代码，可在 IDE 终端中用 git 同步它们的工作：

# In the Antigravity IDE terminal, check the changes written by the agents
git status

# Review diffs before committing
git diff

# Commit stable checkpoints so both agents stay in sync with main branch
git add .
git commit -m "feat: synchronize parallel front-end and back-end agent changes"

适用场景

需要让多个前端、后端或 QA 智能体在同一代码库上并行工作。
需要搭建 Antigravity IDE 与 Antigravity 2.0 Agent Manager 并存的双窗口工作区。
需要纠正提到已集成“Open Agent Manager”按钮的过时操作步骤。

最佳实践

同时并排运行两个应用。
在 Agent Manager 中为每个智能体强制严格的文件夹级边界（范围）。
在让智能体进行大规模重写前，用 git 分支或提交设置检查点。
不要让多个智能体同时编辑同一个文件，否则会导致写入冲突和 git 合并冲突。
不要在黑色图标 IDE 中寻找“Open Agent Manager”按钮；请使用独立的白色图标应用。

限制

本技能假定你拥有在 Windows/macOS 上安装两个应用的本地管理员权限。
文件锁协调依赖标准 IDE 文件系统监视器。若变更未反映，请重新加载 IDE 工作区（Ctrl+R 或开发者重载）。

常见陷阱

问题：智能体互相覆盖代码或陷入写入锁。解决：隔离它们的工作区。若它们必须编辑同一文件，则按顺序编排（例如先运行后端智能体，提交其变更，再运行前端智能体）。
问题：Agent Manager 中的变更在 IDE 中不可见。解决：确认两个应用指向完全相同的绝对文件路径。在 Windows 上注意映射驱动器或符号链接。

技能介绍

用途