Antigravity CLI：多智能体并发编排的AI编程工具实践指南

如果你还在用传统的 AI 编程助手，每次只能在一个对话框里串行处理任务，那么 Google 最新发布的 Antigravity CLI 可能会彻底改变你的开发工作流。这不是简单的工具升级，而是从"单线程对话"到"多智能体并发编排"的架构级变革。

作为 Gemini CLI 的官方继任者，Antigravity CLI 用 Go 重写了整个二进制文件，命令从 gemini 变成了 agy 。但真正关键的变化在于：它引入了异步子智能体模式，让你可以在终端里同时运行多个 AI 代理，每个代理独立处理不同的开发任务，而你继续在主会话中工作。这种并行化能力对于需要处理大型代码库、同时推进多个重构任务的开发者来说，意味着效率的质的飞跃。

更重要的是，Antigravity CLI 不再局限于 Gemini 模型家族，内置支持了 Gemini 3.5 Flash、Gemini 3.1 Pro、Claude Sonnet/Opus 和 GPT-OSS 120B 等多个主流模型，你可以根据任务类型随时切换最优模型。对于还在使用 Gemini CLI 的开发者，需要注意的是个人版用户必须在 2026 年 6 月 18 日前完成迁移，否则将失去模型访问权限。

1. 为什么终端需要多智能体 AI 编程

传统的 AI 编程助手存在一个根本性限制：它们都是单线程的。当你让 AI 助手处理一个大型重构任务时，整个会话会被阻塞，直到任务完成。这在处理中小型项目时可能还能接受，但对于需要同时进行代码重构、测试编写、安全扫描和文档更新的复杂项目来说，这种串行模式严重制约了开发效率。

Antigravity CLI 解决的正是这个痛点。它的异步子智能体模式允许你启动多个后台智能体，每个智能体独立执行任务。比如，你可以让一个智能体重构 API 层，另一个整理测试文件，第三个查找安全漏洞，而你自己继续在主终端中开发新功能。这种并行执行能力特别适合中大型代码库的维护和现代化改造。

从技术架构角度看，从 Node.js 到 Go 的重写不仅仅是语言替换。Go 的 goroutine 提供了更高效的并发模型，这使得 Antigravity CLI 在 SSH 远程会话或资源受限环境中的启动速度和响应性能都有显著提升。对于需要频繁启动 CLI 的自动化脚本来说，这种性能差异会累积成可观的效率提升。

2. Antigravity CLI 核心特性解析

2.1 异步子智能体模式：真正的游戏规则改变者

异步子智能体模式是 Antigravity CLI 最值得关注的新能力。在 TUI 界面中，你可以使用 /agent 命令启动后台智能体：

/agent refactor "Convert all callback-based handlers in @internal/api to use context.Context"

这个命令会启动一个后台智能体来执行指定的重构任务，而不会阻塞你的主会话。你可以继续使用主智能体进行其他开发工作，或者启动更多的子智能体来处理并行任务。

在实际使用中，这种模式特别适合以下场景：

• 大规模代码重构 ：当需要重构整个模块时，可以启动专门的重构智能体
• 自动化测试编写 ：为新增功能并行生成单元测试和集成测试
• 代码质量检查 ：同时运行安全扫描、性能分析和代码规范检查
• 文档生成 ：自动更新 API 文档和项目说明

2.2 三种操作模式覆盖全场景需求

Antigravity CLI 提供了三种明确定位的操作模式，确保在不同场景下都能发挥最佳效果：

交互式智能体模式 是完整的 TUI 界面，直接运行 agy 命令即可进入。这个模式支持文件上下文注入，使用 @filename 和 @**/*.ts 这样的 glob 模式来向 AI 提供代码上下文：

agy @src/main.ts "Explain the main function and suggest improvements"

无头脚本模式 适合自动化集成，可以直接在命令行中执行任务并获取结构化输出：

agy -p "List all TODOs in this codebase" --output-format json

加上 --output-format json 参数后，输出可以直接被下游脚本解析，轻松集成到 CI/CD 流水线中。

异步子智能体模式 前面已经详细介绍，适合那些"设置后不管"的大型任务，让你能够最大化利用并行处理能力。

2.3 AGENTS.md：项目级智能体行为定制

与 Claude Code 的 CLAUDE.md 类似，Antigravity CLI 引入了 AGENTS.md 文件来定制项目级的智能体行为。在项目根目录创建 AGENTS.md 文件，用自然语言描述项目规范：

# 项目开发规范

## 代码风格
- Always use TypeScript with strict mode enabled
- Prefer functional patterns over class-based ones
- Use async/await instead of callbacks
- Follow the existing code formatting rules

## 开发流程
- Run `npm test` after every file modification
- Generate JSDoc comments for all new functions
- Update CHANGELOG.md when adding new features
- Create unit tests for critical business logic

## 安全要求
- Validate all user inputs
- Use parameterized queries for database operations
- Sanitize HTML outputs to prevent XSS attacks

智能体在每次启动时会自动读取并遵循这些规范，确保生成的代码符合项目标准。

2.4 技能系统：可复用的开发工作流

Antigravity CLI 的技能系统让你能够封装常用的开发工作流。在 .agents/skills/ 目录下创建 Markdown 文件，它们会自动变成 TUI 里的 /slash 命令。

例如，创建 .agents/skills/refactor-function.md ：

# 函数重构技能

将回调风格的函数转换为 async/await 模式，保持错误处理的一致性。

## 使用方式
/refactor-function [filename] [funct