---
title: "Editor 工作流"
description: "Antigravity Editor View 的日常工作流：补全、Tab、inline command、terminal command、agent side panel、Problems 和上下文引用。"
verifiedAt: "2026-05-05"
---

Editor View 保留了 VS Code 类 IDE 的肌肉记忆：文件树、编辑器、终端、Problems、扩展、补全和命令。Antigravity 的差异是：这些传统入口可以和 agent side panel、inline command、terminal command、Artifacts 和 Manager Surface 串起来。

> [!NOTE]
> **这一页解决什么问题**：你在 Editor 里应该把 Antigravity 当成“局部协作工具”，而不是把所有任务都扔进 Agent Manager。

## 1. Editor 适合的任务

| 任务 | 推荐入口 | 原因 |
| --- | --- | --- |
| 改一个函数 | inline command 或 side panel | 上下文足够小 |
| 解释报错 | hover 的 Explain and fix 或 Problems | 错误位置明确 |
| 生成一段命令 | terminal command | 直接贴近 shell |
| 让 agent 看当前文件 | side panel + 文件引用 | 避免打开过大 workspace |
| 小范围重构 | Editor + diff review | 人能快速读完 diff |

## 2. Tab 补全

Codelab 展示了几个 Editor 补全能力：

1. 普通代码补全：写代码时按 Tab 接受建议。
2. Tab to import：提示补缺失依赖或 import。
3. Tab to jump：跳到下一个合理编辑点。

这些能力更像“局部加速”，不适合替代完整任务规划。你可以把它当成普通 IDE 智能补全，而不是每次都启动 agent。

## 3. Inline command

官方 Codelab 展示可以在 editor 或 terminal 中用自然语言触发 command。常见模式：

```text
选中一段代码 → Cmd + I（Mac）/ Ctrl + I（Windows）→ 让 Antigravity 重写、解释或生成替代实现
```

适合：

- 改写函数
- 补注释
- 解释一段复杂逻辑
- 生成一个测试样例
- 把 terminal 输出转成排障步骤

不适合：

- 改整个目录
- 设计完整架构
- 操作数据库
- 修改部署配置

## 4. Agent side panel

Editor 中的 side panel 适合“当前文件 + 少量上下文”的协作。你可以用 `@` 引用文件、目录或其他上下文，也可以用 `/` 触发 workflow。

```mermaid
flowchart LR
    File["当前文件"] --> Panel["Agent side panel"]
    Problem["Problems / terminal output"] --> Panel
    Mention["@file / @folder"] --> Panel
    Workflow["/workflow"] --> Panel
    Panel --> Diff["局部 diff"]
    Diff --> Review["人工 review"]
```

> [!TIP]
> 如果你发现自己在 side panel 里描述了 10 个步骤、多个页面、多个验证动作，这个任务应该切到 Planning 或 Agent Manager。

## 5. Problems 与 terminal output

Antigravity 可以从 Problems 面板把错误交给 agent，也可以把 terminal 输出发给 agent。正确用法是：

1. 先保留原始错误，不要手动删掉关键日志。
2. 让 agent 解释“错误发生在哪一层”。
3. 要求它给最小修复方案。
4. 修完后重新跑同一命令验收。

示例 prompt：

```text
解释这段 terminal output。请先判断是依赖、配置、类型还是运行时问题。
只给最小修复方案，不要修改无关文件。
```

## 6. Editor 与 Manager 的切换

Codelab 展示可以在 Editor 和 Agent Manager 间切换。实务上可以这样分：

| 当前状态 | 留在 Editor | 切到 Agent Manager |
| --- | --- | --- |
| 你知道要改哪一段 | ✅ |  |
| 任务需要浏览器验收 |  | ✅ |
| 任务要跑测试和生成 walkthrough |  | ✅ |
| 只是解释一个错误 | ✅ |  |
| 需要同时开多个 workspace |  | ✅ |

## 官方来源

- [Getting Started with Google Antigravity](https://codelabs.developers.google.com/getting-started-google-antigravity)
- [Google Antigravity Documentation](https://antigravity.google/docs)

## 交付标准

Editor 工作流完成后，应该留下可 review 的局部 diff，而不是只得到一段解释。最小标准是：你能说清用了哪个入口、agent 读取了哪些上下文、改动影响哪些文件、复跑了哪个命令或手动检查。只要任务开始涉及多文件、多步骤浏览器验证或持续观察，就把它升级到 Agent Manager。

## 接下来去哪

<Cards>
  <Card title="Browser 与 Artifacts" description="学会用浏览器、截图、录屏和 walkthrough 验收任务。" href="/docs/antigravity/official/03-browser-artifacts" />
  <Card title="Agent 任务循环" description="从原理上拆开计划、执行、观察、验证和反馈。" href="/docs/antigravity/understanding" />
</Cards>
