Antigravity IDE 的 AI 规则体系 (Rules)

在使用 Antigravity IDE 等先进的 AI 代码编辑器时，如何“驯服” AI 代理（Agent），让它生成的代码或文档符合你的个人习惯和项目规范，是一个非常关键的能力。

在 Antigravity IDE 中，管理这种行为规范的核心入口是右侧边栏的 Customizations -> Rules 面板。这里提供了一套清晰且强大的规则分层体系。

一、为什么需要 AI 规则？

默认情况下，AI 虽然聪明，但它并不知道你的具体偏好（比如你喜欢用单引号还是双引号，用 Vue 还是 React，写不写注释等）。通过设定规则（Rules），你可以提前给 AI 设定一个“紧箍咒”或“上下文记忆”，确保它接下来的每一次回答或代码生成都不偏离你的标准。

Antigravity IDE 将规则严格划分为全局 (Global) 和 工作区 (Workspace) 两个层级。

顾名思义，全局规则对你电脑上打开的所有项目都生效。

适用场景： 用于配置你个人的极致偏好和通用底线。
规则示例：
- “永远使用中文进行解释和回答。”
- “在给出代码前，先简短解释一下思路。”
- “不要使用 TailwindCSS 框架。”
如何配置： 在 IDE 右侧的 Customizations -> Rules 面板中，直接添加并将其作用域设置为 Global。这种规则一旦保存，无论你是写前端、后端还是写文档，AI 都会默认遵守。

工作区规则仅在当前打开的项目（Workspace）内生效。当你切换到另一个项目时，这些规则就不存在了。

适用场景： 用于配置特定项目的代码规范、技术栈和业务逻辑约束。
规则示例：
- “当前项目是 Vue 3，请强制使用 Composition API（<script setup>）。”
- “本项目的 UI 库是 Element Plus，生成组件时不要用错。”
- “生成 Markdown 文章时，所有的二级标题必须带上 一、二、三 序号。”（正如本文所遵守的那样）
底层原理与优势： 当你在面板中通过 + Workspace 建立一条规则时，Antigravity IDE 实际上是在你当前项目的根目录下自动生成了一个 .agents/rules/ 文件夹，并在里面存入了一个 Markdown 格式的文件。
- 这种官方且结构化的方式，不仅让你可以在 UI 面板里直观地开启、关闭和管理规则，还可以直接将这个包含规则的文件夹提交到 Git 仓库，与团队成员共享这套 AI 提示词规范。

统一的入口管理： 虽然一些早期的 AI 编辑器习惯在根目录放置隐蔽的 .cursorrules 等文件，但在 Antigravity IDE 中，最推荐的最佳实践是统一使用 .agents/rules/ 目录。这样可以在 IDE 原生的可视化面板中统一管理。
各司其职： 把个人习惯放到 Global，把项目特有约束放到 Workspace，不要混淆。
保持简短精确： 规则描述越精确、边界越清晰，AI 的执行效果越好。避免写入相互矛盾的模糊指令。