安装 Antigravity IDE,完成第一个任务
选对安装入口,打开工作区,通过一个可检查的小任务熟悉编辑器与 Agent。
资料核验 / 更新于 · 8 分钟阅读
你将完成什么
让 Agent 为练习项目生成一份 PROJECT-NOTES.md,说明项目用途、入口文件和运行方法。先学会确认上下文,再让它修改业务代码。练习预计约 15 分钟,下载时间另计。
1. 选对 IDE 安装包
从 官方 IDE 入门文档进入下载页,选择 Antigravity IDE 及对应操作系统的安装包,并核对当前系统要求。
Antigravity 独立桌面应用、IDE 和 CLI 是不同入口。本系列以 IDE 为主;官方产品导航说明了它们的区别。如果打开后看到的是任务管理界面,而不是预期的代码编辑器,先核对安装的产品。
2. 打开练习工作区
完成登录和初始化后,打开本地项目文件夹。Google 官方 IDE Codelab介绍了编辑器、终端和 Agent 面板,其入门练习建议采用需要人工审阅的开发模式。
建议用一个允许修改的小型示例项目。先自行执行 README 中的启动命令,记录原本是否可以正常运行,避免把已有故障误认为 Agent 新增的问题。

先在左侧确认项目目录,再用编辑器核对引用文件,用终端查看真实命令输出。
官方示例截图(原图未修改) · 来源:Google Codelabs · CC BY 4.0 · 点击图片放大
先认清四个区域
| 区域 | 本次练习要检查什么 |
|---|---|
| 左侧 Explorer 文件树 | 当前文件夹中是否有预期的 README 和源码。 |
| 中间 Editor 编辑器 | 能否打开 Agent 引用的文件,逐项比对内容。 |
| 下方 Terminal 终端 | 命令是否在正确项目里执行,启动日志是否保留。 |
| 右侧 Agent 面板 | 在这里发出任务、阅读草稿和反馈修改意见。 |
如果上级文件夹包含多个仓库,直接打开上级目录容易让任务范围含糊。应打开具体项目根目录。空目录可以先写一份介绍项目目标的 README;尚不存在的入口文件,不应要求 Agent 假装已经找到。
留下修改前的基线
Git 项目可以先运行以下只读命令:
git status --short
git diff --stat记下已有改动,任务结束后再对照差异,不要把所有变更都算到 Agent 头上。本练习不要求提交或暂存代码。
3. 发出一个范围明确的任务
在 Agent 面板输入以下本站练习提示词:
检查这个项目,先起草 PROJECT-NOTES.md。
说明项目用途、入口文件,以及你找到的启动和测试命令。
每项结论都注明对应的本地文件。
不要安装依赖,也不要修改应用代码。
没有找到的命令请明确写“未知”,不要自行猜测。
写入文件前,先向我展示草稿。阅读草稿,至少对照检查一个文件引用和一条命令。有错误时指出具体位置;确认内容后,再让 Agent 保存文件。

输入框可通过 @ 添加上下文。图中的模型列表属于官方示例,实际账号看到的选项可能不同。
官方示例截图(原图未修改) · 来源:Google Codelabs · CC BY 4.0 · 点击图片放大
回答太泛时,补充具体上下文
在输入框键入 @,选择真实的 README 或相关配置文件,再缩小追问范围:
结合附加的 README 和项目配置,重新核对启动命令。
指出支持结论的实际脚本或文档原文位置。
区分“找到的命令”和“实际执行过的命令”。一份合格的项目说明应包含:项目用途、入口文件、文档中的命令、尚未确认的问题。“一个现代化 Web 应用”过于宽泛,应该说清用户能完成什么操作。命令写在文档中与命令在本机成功运行是两回事,请分别记录。
4. 验收与排查
完成标准是一份内容准确的项目说明,且没有无关的代码修改。打开文件变更视图,或在 Git 项目中运行 git diff --stat。注意:新建但尚未跟踪的文件不一定出现在 git diff 中,还要直接确认文件已保存。
如果 Agent 描述的不是当前项目,重新打开正确文件夹,并让它先报告正在检查的工作区。如果启动命令失败,先检查项目要求的运行环境,不要立即要求它重写应用。
第一次任务常见问题
| 现象 | 下一步怎么做 |
|---|---|
| 引用了另一个应用的文件 | 核对打开的目录,并附加正确的 README。 |
| 启动命令立即失败 | 对照 README 检查运行时版本与初始化步骤。 |
| 对话里有说明,但文件树找不到 | 要求保存已审阅草稿,然后从文件树打开确认。 |
| 除项目说明外还改了代码 | 与任务前基线比对,逐项决定是否保留这些变更。 |
最终交付物应让另一个人找到入口文件、复现启动过程,并清楚看到哪些错误仍未解决。
继续学习
下一篇:构建一个阅读清单应用。本文提示词是本站设计的练习,具体界面名称可能随版本变化,请对照文中的官方资料。