突发！AG KIT反重力优先智能体工程套件，功能特性与使用指南全揭秘
AG KIT：反重力优先的智能体工程套件
AG KIT是一款反重力优先的智能体工程套件，具备规则、技能、专家智能体、工作流、持久内存、MCP指导、编排功能以及原生安全钩子。其主要运行时环境为Google Antigravity。
主要特性
AG Kit会安装一个完整的 ".agents/" 工作区合约，此版本支持以Antigravity作为生产运行时，不过其他工具或许能读取Markdown组件，但Antigravity之外的运行时行为不在生产兼容性保证范围内。
生产能力实现包括：规则与技能发现，涵盖 ".agents/rules/"、".agents/skills/"、".agents/workflows/" 目录；专家路由，包含20个角色定义和智能路由技能；持久上下文，有 ".agents/memory/" 目录及上下文压缩指导；编排，支持 "/coordinate"、"/orchestrate" 操作，可对Antigravity的 "/agents" 和 "/tasks" 进行编排；MCP工作区配置，具备显式的、支持备份的同步助手；工具安全，有原生的PreToolUse网关，可处理高置信度的破坏性命令；打包，本地Antigravity插件包，带有SHA - 256内容清单；验证工具包，包含CI、Antigravity Doctor、回归测试、依赖审查、CLI和Web检查。
原生安全钩子的作用范围经过精心设计，较为狭窄，它会阻止根文件系统删除、驱动器格式化和原始磁盘覆盖等操作，同时允许进行正常的项目清理，如删除 `dist/` 或 `node_modules/` 目录，但它并不能替代Antigravity的权限设置、工作区信任机制、沙箱环境或人工审批流程。
系统要求
系统要求方面，需要Node.js版本22或更高，用于仓库级别的Antigravity工具；Python版本3.10或更高，用于AG Kit验证器和实用脚本；需为受信任的Google Antigravity工作区；Git用于安全的更新、审查和回滚工作流。当前发布的CLI支持Node.js 18或更高版本；Antigravity集成检查在Node.js 22上运行。
快速开始
项目安装可使用 `npx @vudovn/ag - kit init` 进行安装，也可全局安装CLI：`npm install -g @vudovn/ag - kit`，然后执行 `ag - kit init`。工作区验证时，当Antigravity需要对规则、技能或工作流进行索引时，请勿将 ".agents/" 目录添加到项目的 ".gitignore" 文件中，若要将其保留在本地且不影响发现机制，可将 ".agents/" 添加到 ".git/info/exclude" 文件中，通过 `npm run check:agents`、`npm run check:antigravity`、`npm run test:antigravity` 命令验证工作区。`check:antigravity` 为只读操作，默认的MCP示例中包含 "YOUR_API_KEY"，因此在配置该示例之前，常规的检查会发出警告，只有在所有占位符都被替换后，才可使用严格模式：`node .agents/hooks/antigravity - doctor.mjs --strict`。
打开Antigravity
将仓库作为受信任的工作区打开后，需确认 `/plan`、`/coordinate` 和 `/orchestrate` 等斜杠命令可被识别；确认从 ".agents/skills/" 中选择了相关技能；执行 `npm test` 等常规命令，确认操作被允许；使用模拟负载验证安全钩子，而非直接执行破坏性命令：`printf '%s' '{"tool_args":{"CommandLine":"rm -rf /"}}' | node .agents/hooks/validate - tool - call.mjs`，该命令应返回非零退出码，并输出 “BLOCKED by AG Kit”。
安全更新与回滚
AG Kit的更新支持合并操作，默认情况下，用户拥有的文件和本地修改的受管理文件会被保留。可使用 `ag - kit update --dry - run` 预览具体更新计划；`ag - kit update` 安全合并并创建备份；`ag - kit update --strategy replace` 显式进行完全替换，仍会创建备份；`ag - kit rollback` 恢复最新的更新前备份。更新元数据存储在 ".agents/.ag - kit/" 目录中，备份文件存储在受管理工具包树之外的 ".ag - kit - backups/" 目录中，在将现有安装升级到Antigravity原生版本之前，请阅读 `MIGRATION.md` 文件。
Antigravity原生集成
运行时合约方面，`.agents/antigravity.json` 文件声明了六个受支持的集成阶段，以及AG Kit使用的Antigravity CLI功能，在上游文档未定义最低语义版本时，避免自行定义。原生安全钩子方面，Antigravity会加载 ".agents/hooks.json" 文件，该文件注册了相关内容，若在诊断兼容性问题时需要临时禁用AG Kit钩子，可将 "enabled" 设置为 `false`，重新打开工作区，若负载可能包含敏感数据，请私下报告其格式，请勿删除Antigravity自身的权限控制。
MCP配置
查看工作区MCP计划可使用 `node .agents/hooks/sync - mcp.mjs --check` 和 `node .agents/hooks/sync - mcp.mjs --print` 命令，且不会写入主目录；应用配置时，替换占位符后，可使用 `node .agents/hooks/sync - mcp.mjs --apply --target suite` 或 `node .agents/hooks/sync - mcp.mjs --apply --target cli` 命令将配置应用到支持的目标，除非使用 `--force` 参数，否则同名的现有服务器将被保留，在修改现有目标文件之前，会创建带时间戳的备份，切勿提交真实的MCP凭证。
构建与检查插件
运行 `npm run build:antigravity - plugin` 命令构建插件，在本地安装之前，查看 `dist/antigravity - plugin/` 目录，插件包包含打包的技能、智能体、规则、转换后的工作流命令、原生钩子、MCP示例以及带有SHA - 256条目的 `PLUGIN_CONTENTS.json` 文件，使用 `agy plugin install ./dist/antigravity - plugin` 命令安装插件，使用 `agy plugin list` 命令查看已安装的插件，插件安装为可选操作，仓库原生的 ".agents/" 工作区仍是项目开发的事实来源。
包含组件
AG KIT包含的组件有：20个智能体，用于领域专家和编排角色定义；47项技能，是渐进式领域知识和可执行验证助手；13个工作流，为可重复的斜杠命令流程；6条规则，是工作区范围的路由、安全、设计和编码约束；4个必需主题及索引的内存主题，用于持久的项目约定、决策、偏好和反馈。每个智能体、技能、工作流和规则都有SemVer合约，`.agents/manifest.json`、`.agents/manifest.lock.json` 和 `.agents/DEPENDENCY_GRAPH.md` 文件可确保受管理工具包的可重复性，并检测偏差，可使用 `npm run generate:agents` 和 `npm run check:agents` 命令进行相关操作。
常见工作流
常见工作流的命令及用途如下：`/brainstorm` 用于在实施前探索选项和架构；`/coordinate` 可并行运行可分离的研究或审查任务，然后进行综合；`/create` 能通过结构化关卡创建功能或应用程序；`/debug` 基于证据进行根本原因分析；`/deploy` 执行生产预飞行检查和部署工作流；`/enhance` 安全地修改现有代码库；`/orchestrate` 规划、获取批准、委派给专家并进行验证；`/plan` 创建详细的实施计划和清单；`/preview` 管理本地预览服务器；`/remember` 将持久的项目信息保存到内存中；`/status` 总结活跃工作和阻碍因素；`/test` 设计并执行测试；`/verify` 通过运行检查而非依赖检查来验证更改。
发布与生产关卡
候选版本需完成 `PRODUCTION_CHECKLIST.md` 中的所有自动化检查和手动Antigravity冒烟测试后，方可获得生产批准。所需的GitHub检查包括：工具包验证、CLI测试和包验证、Web代码检查、类型检查、构建和审计、Antigravity原生合约、依赖审查。AG Kit从不要求自动合并、自动部署或自动MCP同步，生产变更应可审查和回滚。
文档
文档包含Antigravity实现细节、迁移指南、生产发布清单、安全策略和运行时威胁模型、智能体流程架构、工具包架构、更新日志、发布设置、参考资料和归属信息。AG Kit是基于Markdown的智能体工程模式的原创开源实现，不包含专有源文件，运行时集成决策基于 ".agents/hooks/README.md" 中链接的公开Antigravity文档和代码实验室。
支持项目
AG Kit采用MIT许可证发布，版权归Vudovn所有。