Antigravity Agent Client Protocol 架构设计与实战

1. Agent Client Protocol 架构设计解析

在现代化开发工具链中，Agent Client Protocol 作为一种高效的能力复用机制，其核心价值在于实现了"能力本体"与"调用逻辑"的优雅分离。这种设计模式在当前主流开发框架中越来越常见，但 Antigravity 的实现方式有其独到之处。

1.1 双层级存储模型

Antigravity 采用 Skills 和 Workflows 的双层架构，这种设计主要基于以下考量：

• Skills（全局库）：相当于系统的"武器库"，存放所有可复用的原子能力。它们被集中安装在用户主目录下（如 ~/.gemini/antigravity/skills），包含：

  • 可执行脚本（Python/Shell等）
  • 预训练模型参数
  • 设计规范文档
  • 最佳实践指南

• Workflows（项目级）：相当于项目的"战术手册"，定义如何组合使用这些能力。它们存储在项目本地的 .agent/workflows 目录中，特点是：

  • 纯Markdown格式，易于版本控制
  • 只包含调用逻辑，不包含实现代码
  • 项目间可自由定制，互不干扰

提示：这种分离设计使得全局能力更新可以自动惠及所有项目，而项目特定的调用方式又不会影响其他项目。

1.2 目录结构规范

标准的技能安装目录结构如下：

code复制~/.gemini/antigravity/skills/
├── skills/                   # 官方基础技能库
│   ├── frontend-design/      # 前端设计能力
│   ├── doc-generation/       # 文档生成能力
│   └── ...                   # 其他基础能力
├── ui-ux-pro-max-skill/      # 第三方高级技能
│   ├── src/                  # 源代码
│   ├── configs/              # 预设配置
│   └── SKILL.md              # 技能说明文档
└── ...                       # 其他技能

项目级Workflows的典型结构：

code复制your-project/
├── .agent/
│   └── workflows/
│       ├── ui-ux-pro-max.md   # 设计系统生成流程
│       ├── frontend-design.md # 前端开发规范
│       └── list-skills.md     # 能力查询工具
└── ...                        # 项目其他文件

2. 技能安装与配置实战

2.1 基础环境准备

在开始安装前，需要确保系统满足以下条件：

1. Python环境：建议3.8+版本，多数技能脚本依赖Python运行

   bash复制python3 --version  # 验证版本
   

2. Git工具：用于从代码仓库克隆技能包

   bash复制git --version  # 验证安装
   

3. 目录权限：确保对用户主目录有写入权限

   bash复制touch ~/test_permission && rm ~/test_permission  # 快速测试
   

2.2 官方技能库安装

Anthropic官方技能库是Antigravity的核心能力来源，安装步骤如下：

1. 创建基础目录结构：

   bash复制mkdir -p ~/.gemini/antigravity/skills
   cd ~/.gemini/antigravity/skills
   

2. 克隆官方仓库（建议使用HTTPS协议以保证安全性）：

   bash复制