Antigravity Kit 安装与使用完全指南

Antigravity Kit 安装与使用完全指南

1. 项目简介

Antigravity Kit 是一个由 Vudovn 开发的综合性 AI Agent 能力扩展工具包。它旨在通过提供预配置的角色（Agents）、技能（Skills）和工作流（Workflows），极大地增强 AI 辅助开发的效率和质量。通过将 .agent 目录集成到你的项目中，你可以立即赋予你的 AI 助手（如 Cursor、Windsurf 等）专业的领域知识和标准化的操作流程。

核心价值

  • 开箱即用：一键安装，立即获得成熟的 AI 协作体系。
  • 角色分工：通过特定角色的 Agent 处理特定任务，提高专业度。
  • 技能增强：为 AI 提供特定技术栈的最佳实践和知识库。
  • 规范统一：通过 Rules 和 Workflows 统一团队的开发规范。

2. 核心特性

  • **16 个专家代理 (Specialist Agents)**：涵盖架构师、后端开发、前端开发、测试工程师等多个专业角色。
  • **40+ 技能模块 (Skills)**：包含 Web 前端、Web 后端、数据库、云服务等领域的具体技术指导。
  • **11 个工作流 (Workflows)**：预定义的任务执行流程，支持 Slash Command（斜杠命令）快速调用。
  • **自动化规则 (Workspace Rules)**：自动约束项目结构和代码风格。

3. 安装指南

前置要求

  • 确保本地已安装 Node.js 环境（用于运行 npx 命令）。

安装命令

在你的项目根目录下，执行以下命令即可初始化 Antigravity Kit：

1
npx ag-kit init

命令参数说明

npx ag-kit init 支持以下参数以满足不同需求：

  • --force：强制覆盖现有的 .agent 目录（如果已存在）。
  • --path <dir>：指定安装目录（默认为当前目录）。
  • --branch <name>：指定从特定的 git 分支安装。
  • --quiet：静默安装，减少日志输出。
  • --dry-run：模拟运行，不进行实际文件写入，用于测试。

常用管理命令

  • 检查状态：查看当前安装的版本和状态。

    1
    npx ag-kit status

  • 更新工具包：获取最新的 Agents 和 Skills。

    1
    npx ag-kit update

4. 目录结构说明

安装完成后，你的项目根目录下会出现一个 .agent 文件夹，其结构如下：

1
2
3
4
5
6
7
.agent/
├── ARCHITECTURE.md    # 核心架构文档，定义系统运作机制
├── agents/            # 存放各个专家 Agent 的定义文件
├── skills/            # 存放各种技术栈的 Skill 知识库
├── workflows/         # 存放预定义的工作流文件 (.md)
├── rules/             # 存放项目级规则文件
└── .shared/           # 共享的资源和工具脚本

5. 快速开始 (Quick Start)

步骤 1：激活 Agent

在你的 AI 编辑器（如 Cursor）中，Antigravity Kit 通常通过 @ 提及或系统提示词自动加载。你可以通过阅读 .agent/agents/ 下的文件了解有哪些可用角色，例如 @Architect（架构师）或 @Frontend（前端）。

步骤 2：使用技能 (Skills)

当你在进行特定任务时（例如“编写一个 Vue 组件”），AI 会自动检索 .agent/skills/web-frontend 下的相关技能，或者你可以显式要求 AI 参考特定技能文档。

步骤 3：运行工作流 (Workflows)

在 Chat 界面中，通过输入对应的 Slash Command（如果编辑器支持）或直接请求运行特定工作流，例如“执行发布流程”。这些工作流定义在 .agent/workflows/ 中。

6. 进阶使用

深入架构

建议阅读 .agent/ARCHITECTURE.md 文件，详细了解 Antigravity Kit 的内部工作原理、技能加载机制以及如何自定义扩展。

自定义扩展

你可以根据项目需求，在 .agent 目录下添加自定义的 Agent 或 Skill。Antigravity Kit 的设计非常灵活，支持团队共享特定的知识库和规范。

8. 实战示例深度解析

为了让你更好地理解 Antigravity Kit 的强大之处，我们来看两个核心组件的实际定义。

示例 1: Orchestrator Agent (总指挥官)

位于 .agent/agents/orchestrator.md，这个 Agent 负责整个任务的统筹与分发。它的定义展示了如何通过 Prompt 约束 AI 的行为边界。

关键特性：

  • **任务前置检查 (Pre-flight)**：强制要求在执行任何操作前先检查 PLAN.md。
  • 角色分发：明确知道何时调用 @Security 进行审计，何时调用 @Frontend 写代码。
  • 苏格拉底式提问：当需求模糊时，它不会盲目猜测，而是主动向用户提问澄清。
1
2
3
4
5
<!-- 摘录自 orchestrator.md -->

Step 0: Pre-flight Check
You must ALWAYS check for the existence of a PLAN.md file using read_file.
If it exists, read it to understand the current project status.

示例 2: Frontend Design Skill (前端设计专家)

位于 .agent/skills/frontend-design/SKILL.md，这个技能包不仅仅是代码片段，更是设计哲学的集合。

核心原则：

  • 心理学驱动：设计依据 Hick’s Law (席克定律) 和 Fitts’ Law (菲茨定律)，而非个人喜好。
  • 拒绝平庸：明确禁止使用某些被 AI 滥用的设计元素（如紫色渐变、Bento Grid），强制要求“高级感”。
  • 先问后做：引用 “Socratic Gate” 概念，在设计前先询问用户的品牌偏好和受众群体。

通过加载这个 Skill，你的 AI 助手瞬间变成一位熟读设计心理学的资深设计师，而不仅仅是一个写 CSS 的工具人。

9. 常见问题 (FAQ)

Q: 安装会影响我现有的代码吗？
A: 不会。所有文件都包含在 .agent 目录下，不会修改你的业务代码。

Q: 如何卸载？
A: 直接删除项目根目录下的 .agent 文件夹即可。

更多详细文档请参考在线文档：antigravity-kit.vercel.app/docs