Antigravity 定制化系统指南
Antigravity 定制化系统用于调整智能体的行为、教它新的工作流、执行规范，并让它与外部工具集成。通过定制，可以把智能体从通用助手转变为专精于你的项目代码库与流程的专家级结对程序员。
定制类型速查
可根据目标选择定制类型：
Rules 配置文件/目录：GEMINI.md、AGENTS.md 作用范围：上下文 / 层级 最适合：强制编码风格、API 限制和本地规范。 详见 Rules Guide。
Skills 配置文件/目录：skills/<name>/SKILL.md 作用范围：按需（渐进式） 最适合：教智能体多步骤流程、运行手册和工具工作流。 详见 Skills Guide。
Plugins 配置文件/目录：plugins/<name>/plugin.json 作用范围：打包 最适合：把相关技能、规则和 MCP 配置打包为一个单元。 详见 Plugins Guide。
Hooks 配置文件/目录：hooks.json 作用范围：生命周期事件 最适合：在特定智能体生命周期节点（例如工具执行前）运行脚本/命令。 详见 Hooks Guide。
MCP Servers 配置文件/目录：mcp_config.json 作用范围：工具集成 最适合：把智能体连接到外部服务和自定义工具提供方。 详见 MCP Guide。
定制发现与位置
Antigravity 会遍历特定目录，自动发现你自己的定制内容。内置定制不通过这种方式发现：由智能体配置指明其挂载的内置定制。
发现位置
工作区定制（项目专属）： 路径：项目根目录下的 .agents/（或 .agent/、_agents/、_agent/）。 用途：通过纳入版本控制（VCS）与团队共享定制。 智能体会从当前工作目录向上走到仓库根（例如包含 .git 的文件夹）来查找这些目录。
目录与项目规则（层级式）： 路径：GEMINI.md、AGENTS.md、.agents/rules/*.md 当你打开或编辑文件时，智能体会从文件所在目录向上走到仓库根，加载沿途找到的所有规则。
全局配置（本机级）： 路径：~/.gemini/config/ 适用于你机器上运行的所有项目和所有工作区。
加载优先级与先后顺序
当发现多个定制时，它们会按特定顺序加载并应用。如果存在名称冲突（例如两个同名技能），优先级更高的定制会覆盖优先级更低的。
优先级从高到低为：
工作区项目：从 CWD 向上走到仓库根的层级式发现。 声明的配置：工作区 skills.json 或 plugins.json 中显式列出的定制。 全局发现：~/.gemini/config/ 内置定制：应用自带的默认技能，按名称挂载而非发现。 全局声明配置：全局 JSON 配置中显式列出的定制。
定制的应用方式
渐进式披露（Skills 与 Rules） 为避免撑爆模型上下文窗口，Antigravity 采用渐进式披露： 技能默认不加载进上下文窗口，只注入其名称和描述。只有当模型（或用户）显式决定激活时，才加载技能的完整内容。 带 trigger: model_decision 的规则行为类似。只有 always_on 规则会无条件加载。
去重 所有定制（尤其是规则）会按解析后的文件路径去重。单个对话轮次内，一个规则文件即使命中多个触发条件，也绝不会被注入多次。
高级管理：JSON 配置
对于存放在非标准位置的定制，可用 skills.json 与 plugins.json 显式注册它们，并继承共享配置。
配置方法见 JSON Configurations Guide。