规则的两种作用域:全局 vs 局部
Antigravity 的规则体系设计非常清晰,分为全局规则和局部规则两种层级,根据开发需求灵活叠加:
适用于你电脑上的所有 Antigravity 项目,无论新建还是打开已有仓库均全局生效。
C:\Users\<用户名>\.gemini\config\AGENTS.md
仅对当前项目工作区生效,适合存放该项目特有的技术栈、语言规范或私有配置。
<工作区根目录>\.agents\AGENTS.md
两种高效配置方法
你可以根据个人习惯,选择直接编辑文件或者让 Agent 自行配置:
直接手动建立或修改规则文件
直接通过文本编辑器(如 VS Code、Notepad)打开上述对应的 AGENTS.md 文件进行修改。如果目录中尚不存在对应文件夹或文件,手动新建即可。
向 Agent 描述要求,让其自动写入配置
更省心的方式是直接在对话框中将规则要求发送给你的 Agent,命令它自行定位并写入规则文件。
💡 发送时将下方整理好的「常见初始化规则」紧随该提示词之后一并发送即可!
常见推荐初始化规则清单
结合高频开发场景总结出的 5 大基础规范(已对反引号与语病进行规范化校对),可直接全量复制应用:
工作区下载限制
AI 助手的所有下载、安装、克隆或新建项目操作,必须全部且仅能在 `指定工作区` 目录(或其子目录)下进行,严禁向其他位置(如 C 盘、用户目录、临时文件夹等)下载或安装文件。
文件修改限制
严禁 AI 助手修改 `指定工作区` 工作区目录之外的任何文件或系统配置。
外部修改询问机制
如因必要原因(如配置系统环境变量等)必须修改工作区之外的文件,必须在执行前使用中文向用户进行明确询问,详细列出:
- 打算修改的文件绝对路径
- 修改的具体原因
- 将要进行的详细修改内容(以 diff 形式展示)
只有在获得用户明确许可后,方可执行该操作。
项目命名规范
在 `指定工作区` 目录下创建新项目时,新建文件夹的命名方式必须为:Project + 序号 + 项目的中文名称(例如 Project01_规则配置)。
其中序号必须在 `指定工作区` 目录下全局统一排序递增(通过扫描该目录下已有 Project 文件夹的最大序号并加 1,不能按单次对话独立从 1 开始排序)。
Python 环境约束
本地所有 Python 脚本应使用指定的虚拟环境解释器(例如:D:\Miniconda3\envs\pyforantigravity\python.exe),避免混用系统默认环境导致依赖冲突。