← 返回主页
03 · 规则配置 · RULES CONFIGURATION

03 / Antigravity规则配置 · 打造高效安全专属Agent

在正式使用 AI Agent 辅助编程与科研之前,为其量身配置运行边界与行为规范,是保障项目安全、消除幻觉、确保目录整洁有序的核心基石。本文详述 Antigravity 的规则体系与一键配置方案。

💡
核心导读: 在开始使用你的 Agent 之前,最好先给它配置一些专属规则,以达到更符合个人习惯的体验效果。这里以 Antigravity 为例,详细阐述如何通过「全局规则」与「局部规则」双层架构,让 AI 助手既懂规矩又更懂你。
核心机制

规则的两种作用域:全局 vs 局部

Antigravity 的规则体系设计非常清晰,分为全局规则和局部规则两种层级,根据开发需求灵活叠加:

🌐 全局规则 (Global Rules)

适用于你电脑上的所有 Antigravity 项目,无论新建还是打开已有仓库均全局生效。

配置路径: C:\Users\<用户名>\.gemini\config\AGENTS.md
📁 局部规则 (Local Rules)

仅对当前项目工作区生效,适合存放该项目特有的技术栈、语言规范或私有配置。

配置路径: <工作区根目录>\.agents\AGENTS.md
实操方案

两种高效配置方法

你可以根据个人习惯,选择直接编辑文件或者让 Agent 自行配置:

途径 1

直接手动建立或修改规则文件

直接通过文本编辑器(如 VS Code、Notepad)打开上述对应的 AGENTS.md 文件进行修改。如果目录中尚不存在对应文件夹或文件,手动新建即可。

途径 2

向 Agent 描述要求,让其自动写入配置

更省心的方式是直接在对话框中将规则要求发送给你的 Agent,命令它自行定位并写入规则文件。

【全局提示词】:将以下规则写入到全局规则文件中,保证以后所有的项目执行的时候都遵守该规则。

💡 发送时将下方整理好的「常见初始化规则」紧随该提示词之后一并发送即可!

最佳实践

常见推荐初始化规则清单

结合高频开发场景总结出的 5 大基础规范(已对反引号与语病进行规范化校对),可直接全量复制应用:

规则 01

工作区下载限制

AI 助手的所有下载、安装、克隆或新建项目操作,必须全部且仅能在 `指定工作区` 目录(或其子目录)下进行,严禁向其他位置(如 C 盘、用户目录、临时文件夹等)下载或安装文件。

规则 02

文件修改限制

严禁 AI 助手修改 `指定工作区` 工作区目录之外的任何文件或系统配置。

规则 03

外部修改询问机制

如因必要原因(如配置系统环境变量等)必须修改工作区之外的文件,必须在执行前使用中文向用户进行明确询问,详细列出:

  1. 打算修改的文件绝对路径
  2. 修改的具体原因
  3. 将要进行的详细修改内容(以 diff 形式展示)

只有在获得用户明确许可后,方可执行该操作。

规则 04

项目命名规范

在 `指定工作区` 目录下创建新项目时,新建文件夹的命名方式必须为:Project + 序号 + 项目的中文名称(例如 Project01_规则配置)。

其中序号必须在 `指定工作区` 目录下全局统一排序递增(通过扫描该目录下已有 Project 文件夹的最大序号并加 1,不能按单次对话独立从 1 开始排序)。

规则 05

Python 环境约束

本地所有 Python 脚本应使用指定的虚拟环境解释器(例如:D:\Miniconda3\envs\pyforantigravity\python.exe),避免混用系统默认环境导致依赖冲突。

📋 需要全量初始化规则? 点击右侧按钮,一键复制包含上述 5 项完整规则的 Markdown 文本
← 上一篇:02 快速自动安装SKILL 下一篇:04 登录排查指南 →
提示内容