规则与工作流 (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 手动合作完成一系列步骤后，这种方式尤其有效，因为它可以利用对话历史记录来自动创建工作流。