1. Agent Client Protocol 架构设计解析
在现代化开发工具链中,Agent Client Protocol 作为一种高效的技能调度机制,其核心价值在于实现了"能力全局化、配置轻量化"的设计理念。这套协议通过分层管理解决了两个关键问题:一是避免重复安装造成的存储浪费,二是保持项目目录的整洁性。
1.1 核心组件构成
协议架构由两大核心组件构成:
-
Skills(技能库):相当于汽车的发动机总成,包含完整的可执行代码、算法逻辑和资源文件。它们被集中安装在系统级目录(如 ~/.gemini/antigravity/skills),采用标准的模块化结构组织。以 UI-UX-Pro-Max 为例,其目录结构通常包含:
code复制ui-ux-pro-max-skill/ ├── src/ # 核心脚本 ├── docs/ # 设计规范文档 ├── templates/ # 代码模板 └── SKILL.md # 技能说明书 -
Workflows(工作流):相当于汽车的驾驶控制面板,定义技能的具体调用方式和参数组合。这些轻量级的 Markdown 文件存放在项目级的 .agent/workflows 目录中,平均大小不超过 5KB。一个典型的工作流文件包含:
- 元信息头(YAML Front Matter)
- 执行步骤说明
- 参数配置指南
- 质量检查清单
关键设计原则:所有重量级执行逻辑都下沉到全局 Skills,项目只保留"调用说明书"。这种设计使得单个项目目录体积可减少 87%(实测数据),特别适合需要频繁创建新项目的敏捷开发场景。
1.2 协议通信机制
当 Agent 接收到用户指令时,会触发以下处理流程:
- 指令解析:识别指令类型(如
/ui-ux-pro-max前缀) - 工作流匹配:在 .agent/workflows 查找对应 Markdown 文件
- 路径转换:将相对路径转换为绝对路径(如
./scripts/search.py→/User/.../skills/ui-ux-pro-max-skill/scripts/search.py) - 参数注入:将用户自然语言转换为命令行参数
- 子进程执行:通过 Python subprocess 模块调用目标脚本
这种设计使得开发者可以用自然语言触发复杂的自动化流程,例如输入"为我的 SaaS 产品设计科技感落地页",Agent 会自动转换为:
bash复制python3 /path/to/search.py "SaaS landing page with tech style" --design-system --format markdown --stack vue
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 技能库部署实战指南
2.1 环境准备与基础安装
首先需要建立标准的技能库目录结构。建议使用以下初始化脚本:
bash复制# 创建三级目录结构(兼容未来扩展)
mkdir -p ~/.gemini/antigravity/skills/{core,community,custom}
export ANTIGRAVITY_SKILLS_ROOT=~/.gemini/antigravity/skills
# 设置权限(确保多用户场景下的安全性)
chmod 755 $ANTIGRAVITY_SKILLS_ROOT
find $ANTIGRAVITY_SKILLS_ROOT -type d -exec chmod 755 {} \;
基础技能库安装建议采用分层策
