Google Antigravity Learning Time - Class 1
从 CLI 重新回到 IDE，我又回到了以前爽用 Curor 的日子(绝对不是因为反代 Antigravity 被封了十几个 Pro 号被迫老实了
)
Antigravity(以下简称 反重力/AG/ag) 开始快乐的学习时光
安装与登录
-
访问 ag 下载页 ，选择自己的平台与安装包点击
-
点击启动
-
配置是否从 VS Code/Cursor/Windsurf 导入，不需要则选 fresh
-
权限控制模式选择
Strict Mode: 严格模式 , 所有 Agent 的操作执行必须审核，所有的命令执行必须审核，浏览器执行脚本必须审核且浏览器 URL 只能访问允许列表中的，Artifact文件必须审核后才执行Review-driven development: 审核开发模式，命令行执行必须审核，Artifact文件必须审核后才能执行，浏览器执行脚本禁用Agent-driven development: Agent 开发模式，命令行执行始终允许，Artifact文件执行始终允许，浏览器执行脚本始终允许Custom configuration: 自定义配置，自己设置命令行执行策略，审核策略与浏览器脚本执行策略看个人喜好设置，没有推荐值，可以选择保守也可以选择激进或自己配置适中的权限
-
快捷键、插件与命令行安装
看个人需要选择 -
登录
注意1： 需要符合 ag 的服务条款地区的账号才能正常使用 Google 授权登录，否则你将得到：
申请帐号的服务条款关联的地区修改参照这个文章《Google 对于帐号的国家/地区判定》注意2: 登录授权需要使用 全局/Tun/虚拟网卡 的代理模式，ag 的架构是前后端，在配置页/登录页选择账号登录的时候没有开全局的代理，前端从 Oauth 页登录会没有办法跟后端通信，一直没有响应
开启全局代理为正常请求
-
条款
现在 ag 已经把第三方使用列为违反条例，使用都是要被 TOS 掉 Gemini CLI/Antigravity 服务，所以反代快乐时光已经过去了
Editor / Agent Manager
编辑器布局
-
布局
熟悉的文件-工作区-Agent 布局，与 VS Code/Cursor 类似
-
Agent 对话窗口
-
Planning/Fast模式选择 -
Planning模式： 基于 PLANNING → EXECUTION → VERIFICATION 三阶段模式，在新需求会先进行这三个阶段的流程，先会生成一个计划文档在Artifacts选项卡，我们可以基于这个 artifact 文档进行审查与提出修改意见
在
Artifacts选项卡下的所有文件都可以进行Comment操作，如：
完成审查与Comment后可以点击Review，并且可以在Review输入框内增加你想要的附加对话
或者没有附加对话可以直接点
Proceed进行执行 -
Fast模式： 顾名思义，快速的执行模式，修改某一个文件的/修改某一段逻辑等，这里不进行展开细说，不过Fast模式仍可以写入Artifacts文件，如 TODO-List 的内容等
-
-
Agent 模型
-
模型有最新的
Gemini 3.1 Pro/Claude Opus 4.6/Claude Sonnet 4.6 -
额度分组：Gemini 3.1 Pro High/Low 为一组, Gemini 3 Flash 单独一组, Claude Opus 4.6/Claude Sonnet 4.6/GPT-OSS 一组
-
额度限量(基于 2.26 新版反代测试)： Pro 号: Claude 分组 5 小时 150~170 次，周限约 300 次, Gemini Pro 分组暂不清楚，Gemini Flash 分组等同于无限
Ultra 号： Claude 分组 5 小时 800 次, Gemini Pro 分组等同于无限，Gemini Flash 分组等同于无限
-
Agent Rules
Global Rules
-
全局规则文件，生成目录在
~/.gemini/GEMINI.md，与 Gemini CLI 共用 -
生成方式：Customizations → Rules → Global 路径添加，或者直接在
~/.gemini/GEMINI.md文件写入
-
Eg:
# 极简防呆工程规范 --- ## 语言规则（language specification） - 优先使用中文进行人机交互 ## 核心工程原则 (Core Principles) - ...... ## 搜索与上下文控制 (Context & Execution Budget) - ...... ## 工具级调度路由 (Deterministic Tool Routing) - ...... ## 浏览器交互规范 (Browser Interaction Protocol) 两套浏览器工具的分工： - **`browser_subagent`（内置）**：用于**复杂多步骤浏览器操作**，如端到端 UI 流程验证、填表提交、多页面跳转。自动录屏保存为 WebP 视频，适合产出可追溯的操作证据。对子代理的 Task 描述必须详尽，明确指定操作步骤、终止条件和需要返回的信息。 - **`playwright` `[MCP]`**：用于**精细粒度的单步操作**，如点击按钮、填充表单、读取快照、截屏。适合已知确切操作目标时的快速交互。优先用 `browser_snapshot` 获取页面结构，不要盲目截屏。 使用场景决策： - 需要录屏留证 / 操作步骤多于 5 步 → `browser_subagent` - 精确点击某个元素 / 检查页面状态 → `playwright` MCP 直接操作 - **降级路径**：Playwright MCP 不可用时，所有浏览器操作回退到 `browser_subagent` ## 自主排障与交付闭环 (Autonomous Bug Fixing & Verification) - **拒绝保姆式交互**：收到 Bug、错误堆栈或失败的 CI 时，直接跟进调用链定位文件并进行修复方案验证，**不要等用户"手把手喂下一步指令"**。但当修复方案涉及架构变更或影响面超出原始报错范围时，仍需走 PLANNING 审批流程。跨模块修复时遵循"先提交再扩散"原则，核心模块修复并验证后再扩展到关联模块。 - **交付前强验证 (Verification Before Done)**：向用户展示成果前，问自己"是否跑过受影响的测试？""是否存在改动带来的副作用？" - 严禁交付无法落地的伪代码或掩耳盗铃的半成品。 ## 经验捕获 (Self-Improvement Loop) - 当因为大模型的固有幻觉或常识误区被用户纠正后，通过 AG 的 KI（Knowledge Items）系统记录经验教训，确保后续对话可检索到该知识点。 - 每次处理相似需求前，先检查已有的 KI 摘要和历史会话记录，避免"反复踩同一个坑"。 ## 变更范围限定 (Change Scope Control) - ...... ## 自检红线清单 (Pre-Flight Checklist) 每次代码输出/文件写入前，必须通过三道红线拦截： 1. **目标对齐**：确认我在解决的是你抛出的实际报错或业务痛点（绝对没有掺杂主观臆造的强行优雅重构）。 2. **变更溯源**：每一行增删改的 diff 均溯源到用户真实意图（没有擅自添加废话注释、无用参数）。 3. **交付实装**：带文件路径定位 `file:line`，以可以直接进入测试周期的状态交付成果。 4. **引用真实**：代码中调用的类、方法、配置项必须来自已读取过的源码或文档，禁止凭记忆臆造 API 签名。不确定时先通过工具验证再引用。
Workspace Rules
新版的反重力中 workspace rules 创建有时候会失败，出现： Failed to create rule: ConnectError: [unknown] no workspaces，不过新版的反重力已经支持了
AGENTS.md文档读取，所以我觉得建不建 workspace 的 rules 都无所谓
[!IMPORTANT]
反重力 1.20.4 版本的 workspace 识别异常，需要使用
workspace的 Rules & Workflows 功能别升级那么快
创建的规则文件在 <项目路径>/.agents/rules 下
主要的几种规则如：
-
Always on: This rule will always be applied, 始终被应用到上下文中，md 表头元数据如下：--- trigger: always_on --- ## Rule No.1 ...... -
Model Decision: Model decides whether to apply the rule, LLM 模型决定是否应用规则到上下文中，md 表头元数据如下：--- trigger: model_decision description: 这个规则适合在xx场景下使用，对于处理xx问题有特殊规则 --- ## Rule No.1 ...... -
Glob: This rule applies to files matching the glob pattern, 通配符模式匹配文件决定是否应用规则到上下文中，md 表头元数据如下：--- trigger: glob globs: src/**/*.java, src/**/*.xml, src/**/*.yaml, *.sql, docs/ --- ## Rule No.1 ...... -
Manual: This rule can be manually activated by using @mention in Agent’s input box, 手动使用@在对话中带入上下文中，md 表头元数据如下：--- trigger: manual --- ## Rule No.1 ......
这些规则在 Cursor 等 IDE 中都是类似的，建议是使用 Glob 模式来匹配不同的文件对应不同的规则，如 *.java 使用一个规则，*.sql 使用另外一个规则，以减少无用的规则被带入到上下文中
Agent Workflows
Global Workflows
-
全局工作流文件，生成目录在
~/.gemini/antigravity/global_workflows，工作流文件的文件名可以在不同的反重力对话窗口中使用/workflow_name带出，类似 Claude Code 中的 skills 执行/skill_name，或者 Codex 中执行$skill_name带出完整的封装提示词 md 内容，反重力的 skills 跟 Claude Code /Codex 的 skills 不太一样，不能直接使用斜线命令直接带出，后面讲到 skills 的时候再细说 -
生成的 md 文件元数据如下：
--- description: you global workflow how or when to use...... --- ## Process 1 ......
Workspace Workflows
-
工作空间目录工作流文件，生成目录在
<项目目录>/.agent/workflows目录[!IMPORTANT]
反重力 1.20.4 版本的 workspace 识别异常，需要使用
workspace的 Rules & Workflows 功能别升级那么快
-
生成的 md 文档元数据如下：
--- description: Implement tasks from an OpenSpec change (Experimental) --- ## Implement tasks from an OpenSpec change. ...... -
生成的
workspaces级别的 workflows 也是可以和Global级别的 workflows 一样使用/斜线命令带出预定义的提示词
Agent Skills
Custom Global Skills
[!IMPORTANT]
可指定目录的全局 Skills 配置，可以指定在~/.claude/skills目录或者~/.codex/skills目录，不过有个重要的点，前面也有提到，不管是全局的 skills 或者项目的 skills 都是无法使用/斜线命令带出的，只能在对话中命中了提示词描述或者 skill name 才会加载 路径反重力 1.20.4 版本的全局 sklls 路径 识别异常，需要使用全局 skills 功能别升级那么快
- 配置方式： Settings → Customization
[!IMPORTANT]
如果是使用的 cc-switch 创建的文件软连接目录 skills 是无法被加载的，类似这种：
所以，如果你是使用的 cc-switch 配置的 skills 并且 skills 的同步模式是软连接目录，无法被加载到反重力上下文中，可以直接指定为 cc-switch 的 skills 目录：~/.cc-switch/skills
- 全局的 skills 目录配置文件位于：
~/.gemini/antigravity/skills.txt，路径内容即是上面配置的路径，可以放入多个，都会按照路径进行加载
// TODO 改天再更新 Class 2 吧
