---
url: /antigravity/rules-workflows.md
description: 学习如何在 Antigravity 2.0 中配置全局与工作空间规则，并使用 Markdown 定义结构化的工作流以实现复杂开发流程的自动化。
---

# 规则与工作流 (Rules & Workflows)

## 规则 (Rules)

规则是用户手动定义的约束条件，供 Agent 在本地或全局级别遵循。规则允许用户引导 Agent 遵循特定于其自身使用场景和编码风格的行为。

### 如何开始使用规则：

1. 点击编辑器 Agent 面板顶部 “...” 下拉菜单，打开 **Customizations**（自定义）面板。
2. 导航至 **Rules** 面板。

* 点击 **“+ Global”** 创建新的全局规则，或者点击 **“+ Workspace”** 创建特定的工作空间规则。

规则本身就是一个 Markdown 文件，您可以在其中输入约束条件，以引导 Agent 契合您的任务、技术栈和风格。每个规则文件限制在 12,000 个字符以内。

### 全局规则 (Global Rules)

全局规则保存在 `~/.gemini/GEMINI.md` 中，并应用于所有工作空间。

### 工作空间规则 (Workspace Rules)

工作空间规则保存在您工作空间或 Git 根目录的 `.agents/rules` 文件夹中。

在规则级别，您可以定义该规则的激活方式：

* **手动 (Manual)**：在 Agent 的输入框中通过 `@提及` 手动激活。
* **始终开启 (Always On)**：该规则将始终被应用。
* **模型决策 (Model Decision)**：基于对规则的自然语言描述，模型自动决定是否应用该规则。
* **Glob 匹配 (Glob)**：根据您定义的 Glob 模式（例如：`.js`, `src/**/*.ts`），该规则将应用于所有匹配该模式的文件。

> \[!NOTE]
> Antigravity 现在默认指向 `.agents/rules`，但仍然保留了对旧路径 `.agent/rules` 的向后兼容。

### @ 提及 (@ Mentions)

您可以在规则文件中使用 `@filename` 引用其他文件。如果文件名是相对路径，它将被解释为相对于该规则文件的位置。如果文件名是绝对路径，它将被解析为真正的绝对路径；否则，它将相对于代码库进行解析。例如，`@/path/to/file.md` 将首先尝试解析为 `/path/to/file.md`，如果该文件不存在，则解析为 `workspace/path/to/file.md`。

## 工作流 (Workflows)

工作流允许您定义一系列步骤，以引导 Agent 完成一组重复性任务，例如部署服务或回复 PR 评论。这些工作流保存为 Markdown 文件，让您能以一种简单且可重复的方式来运行关键流程。保存后，可以在 Agent 中通过格式为 `/workflow-name` 的斜杠命令来调用工作流。

* **规则（Rules）**：通过在 Prompt 级别提供持久、可复用的上下文来为模型提供指导。
* **工作流（Workflows）**：在轨迹（trajectory）级别提供结构化的步骤或 Prompt 序列，引导模型完成一系列互相关联的任务或操作。

### 创建工作流：

1. 点击编辑器 Agent 面板顶部 “...” 下拉菜单，打开 **Customizations** 面板。
2. 导航至 **Workflows** 面板。

* 点击 **“+ Global”** 按钮创建一个可以在所有工作空间中访问的全局工作流，或者点击 **“+ Workspace”** 按钮创建一个特定于当前工作空间的工作流。

要执行工作流，只需在 Agent 中使用 `/workflow-name` 命令调用它即可。您甚至可以在一个工作流内部调用其他工作流！例如，`/workflow-1` 可以包含诸如“调用 /workflow-2”和“调用 /workflow-3”的指令。在调用时，Agent 会按顺序处理工作流中定义的每个步骤，执行操作或按指定生成响应。

工作流保存为 Markdown 文件，包含标题、描述以及供 Agent 遵循的一系列具体步骤指令。每个工作流文件限制在 12,000 个字符以内。

### Agent 生成工作流 (Agent-Generated Workflows)

您还可以让 Agent 为您生成工作流！在与 Agent 手动合作完成一系列步骤后，这种方式尤其有效，因为它可以利用对话历史记录来自动创建工作流。