📌 项目地址：vudovn/ag-kit | ⭐ 7,910 颗星 | 🔧 TypeScript | 📜 未标注
一句话讲清楚
AG KIT 是一套为 Google Antigravity（原“反重力”？下文直接用英文） runtime 设计的 agent 工程工具集。它把 agent 的开发、规则、技能、记忆、编排、MCP 集成以及安全钩子都标准化到了项目里的 .agents/ 目录下，让开发者能按约定组织 agent 行为，而不是各自造轮子。
为什么会有这个项目
如果你用过 LangChain、AutoGPT 或 CrewAI 这类框架，会发现它们都有自己的 agent 抽象和编排方式。但 AG KIT 的定位完全不同：它假设你已经（或准备）使用 Google Antigravity 作为 agent 的运行时环境，然后在此基础上提供一套“工程规范”——从规则发现、角色路由到持久记忆、工具安全拦截，都用目录结构和配置文件来定义，而不是侵入业务的 Python/TypeScript 代码。
换句话说，AG KIT 不是又一个 agent 框架，而是 Antigravity 生态的“项目脚手架 + 最佳实践集合”。它的生产兼容性明确只针对 Antigravity，其他工具可以读取 .agents/ 下的 Markdown 组件，但运行时的行为不在兼容性保障内。
快速上手：安装与验证
1. 安装到项目
npx @vudovn/ag-kit init
或者全局安装：
npm install -g @vudovn/ag-kit
ag-kit init
运行后会在项目根目录生成 .agents/ 目录，包含规则、技能、工作流、记忆、MCP 配置等标准结构。
2. 验证 workspace
npm run check:agents
npm run check:antigravity
npm run test:antigravity
其中 check:antigravity 是只读的，不会修改项目。工具还带一个 doctor 脚本，能检查 MCP 示例里的 API Key 是否替换：
node .agents/hooks/antigravity-doctor.mjs --strict
注意：默认的 MCP 示例包含
YOUR_API_KEY，未替换前 doctor 会报 warning。只有在所有占位符都解析后才建议使用--strict模式。
3. 在 Antigravity 中打开
将仓库作为受信任 workspace 打开后，确认 slash 命令 /plan、/coordinate、/orchestrate 能被发现，并在 .agents/skills/ 中选择合适的技能。
核心功能：工程规范而非黑科技
| 能力 | 实现方式 |
|---|---|
| 规则和技能发现 | .agents/rules/、.agents/skills/、.agents/workflows/ 目录 |
| 专业角色路由 | 20 个角色定义 + 智能路由技能 |
| 持久化上下文 | .agents/memory/ 目录 + 上下文压缩指导 |
| 编排命令 | /coordinate、/orchestrate、Antigravity 的 /agents 和 /tasks |
| MCP（模型上下文协议） | workspace 配置 + 显式的、支持备份的同步助手 |
| 工具安全 | 原生的 PreToolUse 钩子，拦截高危命令（如删除根文件系统、格式化磁盘、覆写原始盘） |
| 打包分发 | 本地 Antigravity 插件 bundle，包含 SHA-256 内容清单 |
| 验证 | Toolkit CI、Antigravity Doctor、回归测试、依赖审查、CLI 和 Web 检查 |
安全钩子的设计哲学
AG KIT 内置的原生安全钩子（PreToolUse）非常克制：它只阻止对根文件系统的删除、驱动器格式化和原始磁盘覆写，但允许正常清理操作（如删除 dist/ 或 node_modules/）。它不取代 Antigravity 自身的权限、workspace 信任、沙箱或人工审批——安全是分层负责的。
生产环境使用须知
- 运行环境要求：Node.js 22+（用于 Antigravity 工具链）、Python 3.10+（用于验证器）、受信任的 Antigravity workspace、Git。
- 不要将
.agents/加入.gitignore：Antigravity 需要读取其中的规则、技能和工作流。如果只想让.agents/保持在本地而不被索引，可以用.git/info/exclude替代。 - 生产兼容性声明：当前版本仅将 Antigravity 作为生产运行时支持，其他工具可以读取 Markdown 组件，但不在官方兼容范围内。
- 迁移与检查：项目提供了 migration guide、production checklist 和 security 文档，建议在生产前参考。
适合谁用
这个项目不是通用的 agent 框架，它只适合已经决定使用 Google Antigravity 作为 agent 运行时的团队。如果你正在评估 agent 开发方案，AG KIT 可以让你快速获得一套经过验证的工程结构（规则、记忆、路由、安全钩子），而不需要从零设计。
如果你是 Antigravity 的现有用户，AG KIT 能帮你把 agent 配置从零散的文件变成可验证、可编排的工程制品。如果你用的是其他运行时（如 AutoGPT、LangChain、OpenAI Assistants API），AG KIT 提供的能力与这些生态不直接兼容，迁移成本较高。
同类工具的差异点
- 与 CrewAI / AutoGPT 相比：AG KIT 不负责 agent 框架内部的推理循环，它只提供 Antigravity 环境下的规范化目录结构和安全钩子。
- 与 LangChain Hub / Smith 相比：AG KIT 是本地优先的工程契约，不依赖云服务。
- 与 MCP 规范 的关系：AG KIT 内置了 MCP 的 workspace 配置和同步助手，但它更偏重在 Antigravity 中的集成，而非 MCP 协议的另一个实现。
一句话总结
如果你是 Antigravity 生态的开发者，AG KIT 是目前最完整的“工程化 agent 开发工具包”；如果不是，它暂时不适用。