Antigravity Agent Client Protocol 设计与实战指南

1. Agent Client Protocol 设计理念解析

在现代化开发工具链中，Antigravity 提出的 Agent Client Protocol 展现了一种优雅的"能力复用"架构。这套协议最核心的创新点在于将"能力实现"与"能力调用"进行了清晰的职责分离，这种设计理念源自于对开发者日常痛点的深刻洞察。

想象一下，你手头同时维护着5个前端项目，每个项目都需要类似的代码审查、UI设计规范检查等功能。传统做法是在每个项目中都复制一套相同的工具脚本，这不仅浪费存储空间，更致命的是当需要更新某个功能时，你不得不逐个项目进行同步修改。Antigravity 的 Skills/Workflows 双轨制正是为解决这个问题而生。

Skills 作为全局能力库，相当于你电脑上的"瑞士军刀套装"。它们被集中安装在 ~/.gemini/antigravity/skills 目录下，包含完整的可执行代码、训练模型和文档。比如官方提供的 frontend-design skill 就内置了超过200种设计模式检测规则和50个现成的Tailwind组件模板。

Workflows 则像是这些"瑞士军刀"的使用说明书，它们以Markdown格式存放在每个项目的 .agent/workflows 目录中。一个典型的 workflow 文件会定义：

• 何时调用哪个skill
• 需要传递哪些参数
• 如何处理返回结果
• 项目特定的配置项

这种架构带来三个显著优势：

1. 空间效率：一个200MB的AI设计辅助skill只需要安装一次，所有项目共享
2. 更新便利：skill的改进会自动惠及所有项目
3. 项目纯净：.agent/目录可以放心加入.gitignore，避免工具链文件污染代码库

提示：建议将全局skills目录加入你的shell环境变量，比如在.zshrc中添加 export ANTIGRAVITY_SKILLS_ROOT=~/.gemini/antigravity/skills，这样在workflow中就可以用变量代替绝对路径。

2. 全局Skills安装与配置详解

2.1 基础环境准备

在开始安装具体skills之前，我们需要建立规范的目录结构。推荐使用以下命令初始化你的全局skills仓库：

bash复制# 创建标准化目录结构
mkdir -p ~/.gemini/antigravity/skills/{official,community,custom}

# 设置正确的目录权限
chmod 755 ~/.gemini/antigravity
find ~/.gemini/antigravity/skills -type d -exec chmod 755 {} \;

这种三级目录结构的设计考虑了长期维护性：

• official/：存放Anthropic等官方维护的skill套件
• community/：来自第三方开发者的优质skill
• custom/：你自己开发的私有skill

2.2 官方Skills安装实战

Anthropic官方提供了基础技能包，这是整个生态系统的核心。以下是具体安装步骤和注意事项：

bash复制cd ~/.gemini/antigravity/skills/official

# 使用--depth=1避免克隆完整git历史
git clone --depth=1 https://github.com/anthropics/skills.git

# 安装依赖项
cd skills
pip install -r requirements.txt --user

安装完成后，你应该看到如下目录结构：

code复制official/
└── skills/
    ├── frontend-design/      # 前端设计辅助
    │   ├── detectors/        # 设计模式检测器
    │   └── templates/        # 组件模板库
    ├─