Agent Client Protocol架构设计与技能库管理实践

1. Agent Client Protocol 架构设计解析

在Antigravity系统中，Agent Client Protocol采用了一种创新的双层架构设计，将能力实现与调用逻辑分离。这种设计模式在现代开发工具链中越来越常见，其核心思想源自Unix哲学中的"单一职责原则"。

1.1 核心组件：Skills与Workflows

**Skills（技能库）**相当于系统的"肌肉"，是实际能力的载体。它们以代码库的形式存储在全局目录（如~/.gemini/antigravity/skills），包含可执行的脚本、模板和实现逻辑。这种集中化管理带来几个显著优势：

• 版本一致性：所有项目使用同一套技能版本，避免碎片化
• 更新效率：一次更新，全局生效
• 存储优化：避免在每个项目中重复存储相同代码

**Workflows（工作流）**则相当于系统的"神经"，定义如何调用这些能力。它们以Markdown配置文件的形式存在于项目本地（.agent/workflows），只包含调用逻辑而不含具体实现。这种轻量级设计使得：

• 项目保持干净，不污染代码库
• 可以针对不同项目定制调用方式
• 易于版本控制（因为文件很小）

提示：建议将.agent/目录加入.gitignore，因为其中包含的是本地调用配置而非核心代码。

1.2 设计哲学解析

这种分离设计借鉴了现代操作系统的动态链接库(DLL)思想，但做了更进一步的抽象。其核心价值主张包括：

1. 关注点分离：实现与调用解耦
2. 可组合性：不同技能可以灵活组合
3. 可扩展性：新增技能不影响现有架构
4. 可维护性：问题定位更清晰（是技能实现问题还是调用逻辑问题）

在实际开发中，这种架构特别适合需要频繁复用通用能力的场景，比如：

• 前端设计系统生成
• 文档自动化
• 测试用例生成
• CI/CD流程

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

2.1 环境准备与目录结构

标准的Antigravity技能库目录结构如下：

code复制~/.gemini/antigravity/skills/
├── skills/               # 官方基础技能库
│   ├── frontend-desi