安装 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 新增的问题。

Antigravity IDE:左侧文件树、中间编辑器、下方终端与右侧 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 保存文件。

Antigravity 的 Agent 输入框与模型选择菜单

输入框可通过 @ 添加上下文。图中的模型列表属于官方示例,实际账号看到的选项可能不同。

官方示例截图(原图未修改) · 来源:Google Codelabs · CC BY 4.0 · 点击图片放大

回答太泛时,补充具体上下文

在输入框键入 @,选择真实的 README 或相关配置文件,再缩小追问范围:

结合附加的 README 和项目配置,重新核对启动命令。
指出支持结论的实际脚本或文档原文位置。
区分“找到的命令”和“实际执行过的命令”。

一份合格的项目说明应包含:项目用途、入口文件、文档中的命令、尚未确认的问题。“一个现代化 Web 应用”过于宽泛,应该说清用户能完成什么操作。命令写在文档中与命令在本机成功运行是两回事,请分别记录。

4. 验收与排查

完成标准是一份内容准确的项目说明,且没有无关的代码修改。打开文件变更视图,或在 Git 项目中运行 git diff --stat。注意:新建但尚未跟踪的文件不一定出现在 git diff 中,还要直接确认文件已保存。

如果 Agent 描述的不是当前项目,重新打开正确文件夹,并让它先报告正在检查的工作区。如果启动命令失败,先检查项目要求的运行环境,不要立即要求它重写应用。

第一次任务常见问题

现象下一步怎么做
引用了另一个应用的文件核对打开的目录,并附加正确的 README。
启动命令立即失败对照 README 检查运行时版本与初始化步骤。
对话里有说明,但文件树找不到要求保存已审阅草稿,然后从文件树打开确认。
除项目说明外还改了代码与任务前基线比对,逐项决定是否保留这些变更。

最终交付物应让另一个人找到入口文件、复现启动过程,并清楚看到哪些错误仍未解决。

继续学习

下一篇:构建一个阅读清单应用。本文提示词是本站设计的练习,具体界面名称可能随版本变化,请对照文中的官方资料。