1. Agent Client Protocol 架构设计解析
在现代化开发工具链中,Agent Client Protocol 作为一种高效的能力复用机制,其核心价值在于实现了"能力本体"与"调用逻辑"的分离。这种设计模式与操作系统共享库的概念异曲同工,但针对开发者工作流进行了深度优化。
1.1 双层级架构设计原理
全局 Skills 层相当于一个中央武器库,存储着所有可复用的能力组件。以 ~/.gemini/antigravity/skills 为根目录的设计考虑了以下关键因素:
- 跨项目隔离性:避免污染系统全局路径(如 /usr/local/bin)
- 用户空间安全:所有操作限制在当前用户目录下
- 版本控制友好:每个技能包可独立进行 git 管理
项目级 Workflows 则如同战术手册,定义如何组合运用这些武器。.agent/workflows 目录的隐藏属性(以点开头)体现了其作为"项目元数据"而非核心代码的定位。这种设计带来三个显著优势:
- 项目体积减少90%以上(实测一个典型项目从380MB降至28MB)
- 版本控制时无需处理技能包更新冲突
- 团队协作时只需共享轻量级workflow文件
1.2 目录结构规范
标准安装后的目录树应呈现以下结构:
code复制~/.gemini/antigravity/skills/
├── skills/ # 基础技能库
│ ├── frontend-design/ # 前端设计核心模块
│ ├── doc-generation/ # 文档自动化
│ └── testing/ # 智能测试套件
└── ui-ux-pro-max-skill/ # 进阶UI能力
├── src/ # 源码目录
├── scripts/ # 可执行脚本
└── SKILL.md # 技能说明文档
注意:建议定期运行
tree -L 3 ~/.gemini/antigravity/skills验证目录完整性,我曾遇到过因路径错误导致技能
