AG Kit 实战指南面向 Google Antigravity 的 AI Agent 工程化工具包完整使用手册【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kitAG Kit 是一套以 Google Antigravity 为首要运行时primary runtime的 AI Agent 工程化工具包agent engineering kit通过一个完整的.agents/工作区契约为项目注入 rules规则、skills技能、20 个领域专家 agent、13 条 slash-command workflows、持久化 memory长期记忆、MCP 配置指导、编排能力以及原生PreToolUse安全钩子。读完本文你将掌握 AG Kit 的安装验证、安全更新与回滚、Antigravity 原生集成的六大阶段、MCP 显式同步、插件打包与生产发布 gate 的完整实战方案。一、项目定位与 Production ProfileAG Kit 在项目中安装一个完整的.agents/工作区契约workspace contract。在本发布版本中Google Antigravity 是唯一获得生产production兼容性承诺的运行时。其他 AI 工具虽然可以读取其中的 Markdown 组件内容但 Antigravity 之外的运行时行为不包含在生产兼容性保证范围内——这意味着团队可以放心围绕.agents/的标准 Markdown 结构进行协作同时只在 Antigravity 中启用生产级执行行为。下表是官方 READMEREADME-VI.md与英文版README.md共同声明的生产能力矩阵能力生产实现方式Rules 与 skills 发现.agents/rules/、.agents/skills/、.agents/workflows/专家导航20 个专家角色定义 智能路由intelligent-routing技能长期上下文.agents/memory/ 上下文压缩context compression指南编排Antigravity 的/coordinate、/orchestrate、/agents、/tasksMCP工作区配置 带 review 与 backup 的显式同步工具工具安全针对高置信度破坏性命令的原生PreToolUse门禁打包本地 Antigravity 插件 bundle SHA-256 内容清单验证Toolkit CI、Antigravity Doctor、回归测试、Dependency Review、CLI 与 Web 检查关于安全钩子的设计边界README 明确强调它是刻意收窄deliberately narrow的只拦截文件系统根目录删除、磁盘格式化、裸盘raw disk覆盖这类高置信度破坏性模式但允许正常的项目清理操作例如删除dist/或node_modules/。同时该钩子不替代Antigravity 自身的权限系统、工作区信任workspace trust、沙箱或人工审批属于补充性防线而非独立的沙箱。从源码可以看到这份生产契约是机器可读的仓库根目录的 package.json 声明了check:agents、check:antigravity、test:antigravity、build:antigravity-plugin等脚本而 .agents/antigravity.json 则以 JSON Schemahooks/antigravity-contract.schema.json形式声明了 discovery、mcp、hooks、orchestration、plugin、validation 六个集成阶段的职责与来源文件。二、环境要求Requirements根据 README-VI.md 与仓库 package.json 的engines字段使用 AG Kit 需要满足Node.js 22 及以上用于仓库级别的 Antigravity 工具链tooling。当前发布的 CLI 本身支持 Node.js 18 及以上但 Antigravity 集成检查套件在 Node.js 22 上运行——这一点在 cli/package.json 中体现为node: 18而根 package.json 为node: 22。Python 3.10 及以上用于 validator 与 utility scripts例如根 package.json 中check:agents调用的.agents/scripts/generate_manifest.py、dependency_graph.py、validate_kit.py。受信任的 Google Antigravity 工作区trusted workspace。Git用于安全更新、review 与 rollback 流程。三、快速开始从安装到运行验证3.1 安装到项目最简单的方式是直接通过 npx 初始化npx vudovn/ag-kit init也可以全局安装 CLI 后初始化npm install -g vudovn/ag-kit ag-kit initCLI 的可执行入口为ag-kit其安装、更新、回滚、状态查询等命令的详细语义见 cli/README.md。重要提示当 Antigravity 需要索引 rules、skills 或 workflows 时不要把.agents/加入项目的.gitignore。如果只想在本地保留该目录而不关闭发现机制应改为把.agents/写入.git/info/exclude。3.2 验证工作区安装完成后运行以下三条命令完成三层验证npm run check:agents npm run check:antigravity npm run test:antigravitycheck:agents调用 Python 脚本重新生成并核对 manifest、依赖图并运行 toolkit 结构校验见根 package.json 中check:agents脚本。check:antigravity只读检查不会改动任何文件。注意默认的 MCP 示例.agents/mcp_config.json中包含YOUR_API_KEY占位符因此在占位符被真实配置替换之前常规 doctor 会输出警告。test:antigravity运行 Antigravity 原生契约的回归测试node --test .agents/hooks/tests/antigravity.test.mjs。只有在所有占位符都处理完毕后才应使用 strict 模式node .agents/hooks/antigravity-doctor.mjs --strict3.3 在 Antigravity 中打开并验收将仓库作为 trusted workspace 打开后按以下四步验收确认/plan、/coordinate、/orchestrate等 slash command 能被识别确认能从.agents/skills/中选择到合适的 skill运行一条普通命令如npm test并确认其被允许执行用模拟 payload 验证安全钩子而不要执行真实的破坏性命令printf %s {tool_args:{CommandLine:rm -rf /}} \ | node .agents/hooks/validate-tool-call.mjs该命令必须以非零退出码结束并输出BLOCKED by AG Kit。这正是 .agents/hooks.json 中注册的PreToolUse门禁在run_command上的实际拦截路径。四、安全更新与回滚Update RollbackAG Kit 的更新是merge-aware合并感知的默认情况下用户自有文件user-owned files以及被本地修改过的 managed 文件都会原样保留。这一机制在 cli/README.md 中有更细的说明更新前会在.agents/.ag-kit/manifest.json记录 SHA-256 基线更新时对比「旧上游版本、当前本地文件、新上游版本」三者从而区分出干净文件自动更新、仅本地改动保留、用户新建文件保留、双方都改动则报冲突四种情形。ag-kit update --dry-run # 精确预览更新计划 ag-kit update # 安全 merge 并创建备份 ag-kit update --strategy replace # 显式全量替换仍然创建备份 ag-kit rollback # 恢复最近一次更新前的备份更新元数据存放在.agents/.ag-kit/备份存放在.ag-kit-backups/位于 managed toolkit 树之外rollback还支持--backup id指定恢复某个具体备份冲突文件会以 incoming 副本形式写入.agents/.ag-kit/conflicts/。如果要把旧安装升级到 Antigravity-native 版本请先阅读 MIGRATION.md其中给出了完整的升级前检查、升级步骤、升级后验证与回滚指引。五、Antigravity 原生集成详解5.1 Runtime Contract六大集成阶段.agents/antigravity.json 是 AG Kit 与 Antigravity 之间的机器可读运行契约声明了六个集成阶段以及 AG Kit 所使用的 Antigravity CLI 能力changelog、plugin、update。该文件刻意不自行设定一个最低语义化版本minimum semantic version因为上游文档尚未公布明确的版本下限version floor。对照 AGENT_FLOW.md 中的「Six production integration phases」六个阶段及其职责如下阶段职责事实来源source of truth1. Discovery加载 rules、skills、workflows.agents/rules/、.agents/skills/、.agents/workflows/2. MCP校验工作区 server显式同步已 review 的配置.agents/mcp_config.json3. Hooks拦截高置信度破坏性命令模式.agents/hooks.json与.agents/hooks/validate-tool-call.mjs4. Orchestration协调专家角色不另造调度器workflows、agent 定义、Antigravity/agents与/tasks5. Plugin打包已 review 的组件用于可选本地安装.agents/hooks/build-plugin.mjs6. Validation证明结构、兼容性、安全性、CLI 与 Web 健康CI、Doctor、回归测试、PRODUCTION_CHECKLIST.md5.2 Native Safety HookPreToolUse 门禁Antigravity 会读取.agents/hooks.json并注册一个PreToolUse钩子。仓库中实际的 .agents/hooks.json 内容如下{ $schema: hooks/antigravity-hooks.schema.json, enabled: true, PreToolUse: [ { matcher: run_command, command: node .agents/hooks/validate-tool-call.mjs, timeout: 10 } ] }字段说明matcher匹配的工具名当前只针对run_commandcommand每次工具调用前执行的校验脚本路径timeout钩子脚本的超时时间秒默认 10 秒避免钩子自身卡死拖住整个工具调用enabled总开关。排查兼容性问题时如需临时关闭 AG Kit 的钩子只需把enabled设为false重新打开工作区即可如果相关日志可能包含敏感数据应通过私密渠道反馈 payload。切勿删除 Antigravity 自身的权限控制。从实现层面看MIGRATION.md 补充了钩子的失败模式语义当 Antigravity 发送了无效 JSON 或无法识别的命令 payload 时钩子采取fail open开放失败避免上游 payload 变更后锁死整个工作区而对有效且可识别出的破坏性命令则fail closed关闭失败以非零退出码阻止执行。此外 AGENT_FLOW.md 列出的运行时安全规则也再次强调破坏性行为必须用模拟 payload 测试绝不执行真实破坏命令。5.3 MCP 配置显式、带备份的同步MCP 同步遵循「先 review后显式 apply」的原则。先在只读模式下查看合并计划不会写入 home 目录node .agents/hooks/sync-mcp.mjs --check node .agents/hooks/sync-mcp.mjs --print替换掉占位符后显式应用到某一个受支持的 targetnode .agents/hooks/sync-mcp.mjs --apply --target suite node .agents/hooks/sync-mcp.mjs --apply --target cli同步规则见 .agents/antigravity.json 中 mcp 阶段定义与 MIGRATION.mdsuite对应全局配置~/.gemini/config/mcp_config.jsoncli对应~/.gemini/antigravity-cli/mcp_config.json未解析的占位符会阻止--apply写入同名的既有 server 会被保留除非显式使用--force修改已存在的 target 文件之前会先创建一个带时间戳的备份永远不要把真实的 MCP 凭据提交进版本控制——仓库中的 .agents/mcp_config.json 默认示例使用context7server 与YOUR_API_KEY占位符它作为工作区的事实来源不会被自动复制到 home 目录。5.4 构建与检查插件 Bundlenpm run build:antigravity-plugin构建产物位于dist/antigravity-plugin/安装前应先 review。bundle 中包含打包后的 skills、agents、rules、转换后的 workflow 命令、native hook、MCP 示例以及带 SHA-256 条目清单的PLUGIN_CONTENTS.json对应 cli/README.md 中所说本地插件 bundle 附带 SHA-256 内容清单。本地安装与查看agy plugin install ./dist/antigravity-plugin agy plugin list插件安装是可选的仓库内的.agents/工作区始终是项目开发的 source of truth。构建脚本位于 .agents/hooks/build-plugin.mjs。六、内置组件清单Included ComponentsREADME 给出了当前版本随附的完整组件统计组件数量用途Agents20领域专家与编排角色定义Skills47按需加载的领域知识与可执行的校验 helperWorkflows13可复用的 slash-command 流程Rules6全工作区的路由、安全、设计与编码约束Memory topics4 个必选主题 index长期的约定、决策、偏好与反馈每一个 agent、skill、workflow 和 rule 都带有SemVer 契约。.agents/manifest.json、.agents/manifest.lock.json与.agents/DEPENDENCY_GRAPH.md三个文件共同保证 managed toolkit 可复现reproducible并能检测 drift漂移。这也与根 package.json 的generate:agents/check:agents脚本呼应npm run generate:agents npm run check:agents其中generate:agents会调用.agents/scripts/generate_manifest.py生成 manifest并调用.agents/scripts/dependency_graph.py生成依赖图。关于版本解析层的机制AGENT_FLOW.md 描述了完整链路Request → Workflow metadata → Agent version → Skill range → Tool boundary → Verification artifact即在调用 agent 之前会解析.agents/manifest.json中的组件契约并按 agent 声明的 SemVer 范围校验所选 skill 版本。七、常用 WorkflowsSlash Command以下 13 条命令覆盖了从构思到上线的完整开发闭环是文档明确列出的一线工作流命令用途/brainstorm编码前分析方案与架构/coordinate并行运行可拆分的 research/review 任务后综合结果/create按结构化 gate 创建功能或应用/debug基于证据的根因分析/deploy执行生产前 pre-flight 与部署流程/enhance安全地修改现有代码库/orchestrate规划、申请批准、分派给专家并验证/plan生成实施计划与 checklist/preview管理本地 preview server/remember将持久信息写入 memory/status汇总当前工作与阻塞项/test设计与执行测试/verify用实际执行结果证明改动而非仅靠阅读代码其中/coordinate与/orchestrate被 .agents/antigravity.json 的 orchestration 阶段列为核心工作流配套的编排角色orchestrator、project-planner、security-auditor、test-engineer与技能coordinator-mode、parallel-agents、intelligent-routing、verify-changes也在契约中一一对应。需要强调的是AG Kit 的编排不创建第二个调度器而是复用 Antigravity 的/agents与/tasks作为运行时状态。八、Release 与生产 Gate一个 release candidate 只有在 PRODUCTION_CHECKLIST.md 中的全部自动化检查与 Antigravity 手工 smoke test 完成后才被视为 production-approved。CI 中强制要求的 GitHub check 包括Toolkit validationtoolkit 结构校验CLI tests and package validationCLI 测试与包校验Web lint, typecheck, build, and auditWeb 侧质量与安全审计Antigravity native contractAntigravity 原生契约Dependency Review依赖审查AG Kit不要求自动合并auto-merge、自动部署auto-deploy或自动 MCP 同步生产变更必须保持可 review、可回滚reversible。这一原则同样贯穿于 MIGRATION.md 的升级流程升级前先ag-kit update --dry-run预览计划升级前创建备份本地修改过的 managed 文件不会被静默覆盖。九、延伸阅读与文档地图围绕本文涉及的各项能力仓库提供了以下配套文档均为仓库根目录相对路径可直接跳转阅读.agents/hooks/README.mdAntigravity 集成实现细节安全策略、doctor、MCP 同步、插件构建、schema 与测试MIGRATION.md从旧安装迁移到 Antigravity-native 版本的完整指南PRODUCTION_CHECKLIST.md生产发布 checklistSECURITY.md安全策略与运行时威胁模型AGENT_FLOW.mdAgent 流程架构与六大生产集成阶段.agents/ARCHITECTURE.mdToolkit 架构CHANGELOG.md 与 .github/RELEASE_SETUP.md变更记录与发布配置cli/README.mdCLI 的完整命令、选项与退出码说明.agents/antigravity.json 与 .agents/hooks.json运行契约与钩子注册的机器可读事实来源AG Kit 是基于 Markdown 的 agent 工程模式的原创开源实现不包含任何专有源文件其运行时集成决策均依据公开的 Antigravity 文档与 codelab见 .agents/hooks/README.md 中的链接并按 MIT License 发布。对于想要把 AI Agent 工作流工程化、可复现、可回滚地落到生产环境的团队从本文的安装验证、安全更新、原生集成到发布 gate 全链路即可获得一套开箱即用的起点。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 
长河君 · 2026/9/17 4:43:28 · 阅读 1.2k AG Kit 实战指南：面向 Google Antigravity 的 AI Agent 工程化工具包完整使用手册
AG Kit 实战指南面向 Google Antigravity 的 AI Agent 工程化工具包完整使用手册【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kitAG Kit 是一套以 Google Antigravity 为首要运行时primary runtime的 AI Agent 工程化工具包agent engineering kit通过一个完整的.agents/工作区契约为项目注入 rules规则、skills技能、20 个领域专家 agent、13 条 slash-command workflows、持久化 memory长期记忆、MCP 配置指导、编排能力以及原生PreToolUse安全钩子。读完本文你将掌握 AG Kit 的安装验证、安全更新与回滚、Antigravity 原生集成的六大阶段、MCP 显式同步、插件打包与生产发布 gate 的完整实战方案。一、项目定位与 Production ProfileAG Kit 在项目中安装一个完整的.agents/工作区契约workspace contract。在本发布版本中Google Antigravity 是唯一获得生产production兼容性承诺的运行时。其他 AI 工具虽然可以读取其中的 Markdown 组件内容但 Antigravity 之外的运行时行为不包含在生产兼容性保证范围内——这意味着团队可以放心围绕.agents/的标准 Markdown 结构进行协作同时只在 Antigravity 中启用生产级执行行为。下表是官方 READMEREADME-VI.md与英文版README.md共同声明的生产能力矩阵能力生产实现方式Rules 与 skills 发现.agents/rules/、.agents/skills/、.agents/workflows/专家导航20 个专家角色定义 智能路由intelligent-routing技能长期上下文.agents/memory/ 上下文压缩context compression指南编排Antigravity 的/coordinate、/orchestrate、/agents、/tasksMCP工作区配置 带 review 与 backup 的显式同步工具工具安全针对高置信度破坏性命令的原生PreToolUse门禁打包本地 Antigravity 插件 bundle SHA-256 内容清单验证Toolkit CI、Antigravity Doctor、回归测试、Dependency Review、CLI 与 Web 检查关于安全钩子的设计边界README 明确强调它是刻意收窄deliberately narrow的只拦截文件系统根目录删除、磁盘格式化、裸盘raw disk覆盖这类高置信度破坏性模式但允许正常的项目清理操作例如删除dist/或node_modules/。同时该钩子不替代Antigravity 自身的权限系统、工作区信任workspace trust、沙箱或人工审批属于补充性防线而非独立的沙箱。从源码可以看到这份生产契约是机器可读的仓库根目录的 package.json 声明了check:agents、check:antigravity、test:antigravity、build:antigravity-plugin等脚本而 .agents/antigravity.json 则以 JSON Schemahooks/antigravity-contract.schema.json形式声明了 discovery、mcp、hooks、orchestration、plugin、validation 六个集成阶段的职责与来源文件。二、环境要求Requirements根据 README-VI.md 与仓库 package.json 的engines字段使用 AG Kit 需要满足Node.js 22 及以上用于仓库级别的 Antigravity 工具链tooling。当前发布的 CLI 本身支持 Node.js 18 及以上但 Antigravity 集成检查套件在 Node.js 22 上运行——这一点在 cli/package.json 中体现为node: 18而根 package.json 为node: 22。Python 3.10 及以上用于 validator 与 utility scripts例如根 package.json 中check:agents调用的.agents/scripts/generate_manifest.py、dependency_graph.py、validate_kit.py。受信任的 Google Antigravity 工作区trusted workspace。Git用于安全更新、review 与 rollback 流程。三、快速开始从安装到运行验证3.1 安装到项目最简单的方式是直接通过 npx 初始化npx vudovn/ag-kit init也可以全局安装 CLI 后初始化npm install -g vudovn/ag-kit ag-kit initCLI 的可执行入口为ag-kit其安装、更新、回滚、状态查询等命令的详细语义见 cli/README.md。重要提示当 Antigravity 需要索引 rules、skills 或 workflows 时不要把.agents/加入项目的.gitignore。如果只想在本地保留该目录而不关闭发现机制应改为把.agents/写入.git/info/exclude。3.2 验证工作区安装完成后运行以下三条命令完成三层验证npm run check:agents npm run check:antigravity npm run test:antigravitycheck:agents调用 Python 脚本重新生成并核对 manifest、依赖图并运行 toolkit 结构校验见根 package.json 中check:agents脚本。check:antigravity只读检查不会改动任何文件。注意默认的 MCP 示例.agents/mcp_config.json中包含YOUR_API_KEY占位符因此在占位符被真实配置替换之前常规 doctor 会输出警告。test:antigravity运行 Antigravity 原生契约的回归测试node --test .agents/hooks/tests/antigravity.test.mjs。只有在所有占位符都处理完毕后才应使用 strict 模式node .agents/hooks/antigravity-doctor.mjs --strict3.3 在 Antigravity 中打开并验收将仓库作为 trusted workspace 打开后按以下四步验收确认/plan、/coordinate、/orchestrate等 slash command 能被识别确认能从.agents/skills/中选择到合适的 skill运行一条普通命令如npm test并确认其被允许执行用模拟 payload 验证安全钩子而不要执行真实的破坏性命令printf %s {tool_args:{CommandLine:rm -rf /}} \ | node .agents/hooks/validate-tool-call.mjs该命令必须以非零退出码结束并输出BLOCKED by AG Kit。这正是 .agents/hooks.json 中注册的PreToolUse门禁在run_command上的实际拦截路径。四、安全更新与回滚Update RollbackAG Kit 的更新是merge-aware合并感知的默认情况下用户自有文件user-owned files以及被本地修改过的 managed 文件都会原样保留。这一机制在 cli/README.md 中有更细的说明更新前会在.agents/.ag-kit/manifest.json记录 SHA-256 基线更新时对比「旧上游版本、当前本地文件、新上游版本」三者从而区分出干净文件自动更新、仅本地改动保留、用户新建文件保留、双方都改动则报冲突四种情形。ag-kit update --dry-run # 精确预览更新计划 ag-kit update # 安全 merge 并创建备份 ag-kit update --strategy replace # 显式全量替换仍然创建备份 ag-kit rollback # 恢复最近一次更新前的备份更新元数据存放在.agents/.ag-kit/备份存放在.ag-kit-backups/位于 managed toolkit 树之外rollback还支持--backup id指定恢复某个具体备份冲突文件会以 incoming 副本形式写入.agents/.ag-kit/conflicts/。如果要把旧安装升级到 Antigravity-native 版本请先阅读 MIGRATION.md其中给出了完整的升级前检查、升级步骤、升级后验证与回滚指引。五、Antigravity 原生集成详解5.1 Runtime Contract六大集成阶段.agents/antigravity.json 是 AG Kit 与 Antigravity 之间的机器可读运行契约声明了六个集成阶段以及 AG Kit 所使用的 Antigravity CLI 能力changelog、plugin、update。该文件刻意不自行设定一个最低语义化版本minimum semantic version因为上游文档尚未公布明确的版本下限version floor。对照 AGENT_FLOW.md 中的「Six production integration phases」六个阶段及其职责如下阶段职责事实来源source of truth1. Discovery加载 rules、skills、workflows.agents/rules/、.agents/skills/、.agents/workflows/2. MCP校验工作区 server显式同步已 review 的配置.agents/mcp_config.json3. Hooks拦截高置信度破坏性命令模式.agents/hooks.json与.agents/hooks/validate-tool-call.mjs4. Orchestration协调专家角色不另造调度器workflows、agent 定义、Antigravity/agents与/tasks5. Plugin打包已 review 的组件用于可选本地安装.agents/hooks/build-plugin.mjs6. Validation证明结构、兼容性、安全性、CLI 与 Web 健康CI、Doctor、回归测试、PRODUCTION_CHECKLIST.md5.2 Native Safety HookPreToolUse 门禁Antigravity 会读取.agents/hooks.json并注册一个PreToolUse钩子。仓库中实际的 .agents/hooks.json 内容如下{ $schema: hooks/antigravity-hooks.schema.json, enabled: true, PreToolUse: [ { matcher: run_command, command: node .agents/hooks/validate-tool-call.mjs, timeout: 10 } ] }字段说明matcher匹配的工具名当前只针对run_commandcommand每次工具调用前执行的校验脚本路径timeout钩子脚本的超时时间秒默认 10 秒避免钩子自身卡死拖住整个工具调用enabled总开关。排查兼容性问题时如需临时关闭 AG Kit 的钩子只需把enabled设为false重新打开工作区即可如果相关日志可能包含敏感数据应通过私密渠道反馈 payload。切勿删除 Antigravity 自身的权限控制。从实现层面看MIGRATION.md 补充了钩子的失败模式语义当 Antigravity 发送了无效 JSON 或无法识别的命令 payload 时钩子采取fail open开放失败避免上游 payload 变更后锁死整个工作区而对有效且可识别出的破坏性命令则fail closed关闭失败以非零退出码阻止执行。此外 AGENT_FLOW.md 列出的运行时安全规则也再次强调破坏性行为必须用模拟 payload 测试绝不执行真实破坏命令。5.3 MCP 配置显式、带备份的同步MCP 同步遵循「先 review后显式 apply」的原则。先在只读模式下查看合并计划不会写入 home 目录node .agents/hooks/sync-mcp.mjs --check node .agents/hooks/sync-mcp.mjs --print替换掉占位符后显式应用到某一个受支持的 targetnode .agents/hooks/sync-mcp.mjs --apply --target suite node .agents/hooks/sync-mcp.mjs --apply --target cli同步规则见 .agents/antigravity.json 中 mcp 阶段定义与 MIGRATION.mdsuite对应全局配置~/.gemini/config/mcp_config.jsoncli对应~/.gemini/antigravity-cli/mcp_config.json未解析的占位符会阻止--apply写入同名的既有 server 会被保留除非显式使用--force修改已存在的 target 文件之前会先创建一个带时间戳的备份永远不要把真实的 MCP 凭据提交进版本控制——仓库中的 .agents/mcp_config.json 默认示例使用context7server 与YOUR_API_KEY占位符它作为工作区的事实来源不会被自动复制到 home 目录。5.4 构建与检查插件 Bundlenpm run build:antigravity-plugin构建产物位于dist/antigravity-plugin/安装前应先 review。bundle 中包含打包后的 skills、agents、rules、转换后的 workflow 命令、native hook、MCP 示例以及带 SHA-256 条目清单的PLUGIN_CONTENTS.json对应 cli/README.md 中所说本地插件 bundle 附带 SHA-256 内容清单。本地安装与查看agy plugin install ./dist/antigravity-plugin agy plugin list插件安装是可选的仓库内的.agents/工作区始终是项目开发的 source of truth。构建脚本位于 .agents/hooks/build-plugin.mjs。六、内置组件清单Included ComponentsREADME 给出了当前版本随附的完整组件统计组件数量用途Agents20领域专家与编排角色定义Skills47按需加载的领域知识与可执行的校验 helperWorkflows13可复用的 slash-command 流程Rules6全工作区的路由、安全、设计与编码约束Memory topics4 个必选主题 index长期的约定、决策、偏好与反馈每一个 agent、skill、workflow 和 rule 都带有SemVer 契约。.agents/manifest.json、.agents/manifest.lock.json与.agents/DEPENDENCY_GRAPH.md三个文件共同保证 managed toolkit 可复现reproducible并能检测 drift漂移。这也与根 package.json 的generate:agents/check:agents脚本呼应npm run generate:agents npm run check:agents其中generate:agents会调用.agents/scripts/generate_manifest.py生成 manifest并调用.agents/scripts/dependency_graph.py生成依赖图。关于版本解析层的机制AGENT_FLOW.md 描述了完整链路Request → Workflow metadata → Agent version → Skill range → Tool boundary → Verification artifact即在调用 agent 之前会解析.agents/manifest.json中的组件契约并按 agent 声明的 SemVer 范围校验所选 skill 版本。七、常用 WorkflowsSlash Command以下 13 条命令覆盖了从构思到上线的完整开发闭环是文档明确列出的一线工作流命令用途/brainstorm编码前分析方案与架构/coordinate并行运行可拆分的 research/review 任务后综合结果/create按结构化 gate 创建功能或应用/debug基于证据的根因分析/deploy执行生产前 pre-flight 与部署流程/enhance安全地修改现有代码库/orchestrate规划、申请批准、分派给专家并验证/plan生成实施计划与 checklist/preview管理本地 preview server/remember将持久信息写入 memory/status汇总当前工作与阻塞项/test设计与执行测试/verify用实际执行结果证明改动而非仅靠阅读代码其中/coordinate与/orchestrate被 .agents/antigravity.json 的 orchestration 阶段列为核心工作流配套的编排角色orchestrator、project-planner、security-auditor、test-engineer与技能coordinator-mode、parallel-agents、intelligent-routing、verify-changes也在契约中一一对应。需要强调的是AG Kit 的编排不创建第二个调度器而是复用 Antigravity 的/agents与/tasks作为运行时状态。八、Release 与生产 Gate一个 release candidate 只有在 PRODUCTION_CHECKLIST.md 中的全部自动化检查与 Antigravity 手工 smoke test 完成后才被视为 production-approved。CI 中强制要求的 GitHub check 包括Toolkit validationtoolkit 结构校验CLI tests and package validationCLI 测试与包校验Web lint, typecheck, build, and auditWeb 侧质量与安全审计Antigravity native contractAntigravity 原生契约Dependency Review依赖审查AG Kit不要求自动合并auto-merge、自动部署auto-deploy或自动 MCP 同步生产变更必须保持可 review、可回滚reversible。这一原则同样贯穿于 MIGRATION.md 的升级流程升级前先ag-kit update --dry-run预览计划升级前创建备份本地修改过的 managed 文件不会被静默覆盖。九、延伸阅读与文档地图围绕本文涉及的各项能力仓库提供了以下配套文档均为仓库根目录相对路径可直接跳转阅读.agents/hooks/README.mdAntigravity 集成实现细节安全策略、doctor、MCP 同步、插件构建、schema 与测试MIGRATION.md从旧安装迁移到 Antigravity-native 版本的完整指南PRODUCTION_CHECKLIST.md生产发布 checklistSECURITY.md安全策略与运行时威胁模型AGENT_FLOW.mdAgent 流程架构与六大生产集成阶段.agents/ARCHITECTURE.mdToolkit 架构CHANGELOG.md 与 .github/RELEASE_SETUP.md变更记录与发布配置cli/README.mdCLI 的完整命令、选项与退出码说明.agents/antigravity.json 与 .agents/hooks.json运行契约与钩子注册的机器可读事实来源AG Kit 是基于 Markdown 的 agent 工程模式的原创开源实现不包含任何专有源文件其运行时集成决策均依据公开的 Antigravity 文档与 codelab见 .agents/hooks/README.md 中的链接并按 MIT License 发布。对于想要把 AI Agent 工作流工程化、可复现、可回滚地落到生产环境的团队从本文的安装验证、安全更新、原生集成到发布 gate 全链路即可获得一套开箱即用的起点。【免费下载链接】ag-kit项目地址: https://gitcode.com/GitHub_Trending/an/ag-kit创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考