Antigravity 先规划再开发的 Vibe Coding 实践

这种方式能有效避免 Agent 在复杂项目中“写飞”或过早陷入细节。

核心路径：Spec -> Plan -> Code

第一阶段：编写规格说明书 (The Spec)

不要直接在对话框里描述复杂需求。建议在项目根目录下创建一个 Markdown 文件（如 specs.md 或 requirements.md），作为唯一事实来源 (Single Source of Truth)。

● 内容建议：

○ 核心目标：一句话描述要做什么。

○ 技术栈约束：明确指定框架（React/Vue）、UI 库、状态管理方案。

○ 数据结构：提前定义好 Interface / Type。

○ UI/UX 细节：如果有截图，可作为附件引用；如果没有，用文字详细描述交互。

● 优势：Agent 会将此文件作为核心 Context，后续开发偏离时，你可以直接引用“请遵守 specs.md 第 3 条”。

第二阶段：生成实施计划 (Implementation Plan)

这是 Antigravity 的核心 Artifact（制品）功能。

● 操作：在对话框输入指令，明确要求只计划、不写代码。

○ Prompt 示例：“阅读 specs.md，为我生成一份详细的 Implementation Plan。在获得我批准之前，不要编写任何功能代码。”

● 产物：Agent 会生成一个 Implementation Plan Artifact。这是一个交互式文档，通常包含：

○ 拟创建/修改的文件列表。

○ 关键技术决策说明。

○ 分步执行的 Task List。

● 复查 (Review)：你可以在此阶段直接修改 Plan 的内容（例如删除不需要的步骤、补充遗漏的逻辑）。这是控制项目质量的关键节点。

第三阶段：批准与执行 (Approval & Execution)

● 操作：点击 Plan 下方的 “Approve” 或 “Proceed” 按钮。

● 行为：Agent 开始按照 Plan 中的 Task List 逐条执行：

a. 创建文件。

b. 编写代码。

c. 运行终端命令（安装依赖）。

d. 调用 Browser Subagent 进行自我验证（如果配置了）。

第四阶段：验证与迭代 (Verify)

● Antigravity 会在执行完成后生成 Walkthrough（演示/总结）或 Browser Recording。

● 纠错：如果发现实现与 specs.md 不符，不要直接口头纠正，建议先更新 specs.md，然后让 Agent “重新读取 specs 并修正代码”。

关键设置：Artifact Review Policy

为了强制执行“先看再跑”，请检查设置：

● 路径：Settings -> Agent -> Artifact Review Policy

● 建议值：设置为 “Request Review” (请求审查) 或 “Agent Decides” (默认)。

● 避免：不要设置为 “Always Proceed”，否则 Agent 可能会跳过确认直接修改代码。

总结操作流

Touch specs.md (手动写)

Prompt: “Read specs.md, create Implementation Plan” (Agent 生成)

Review Plan (人工确认)

Click “Proceed” (Agent 自动执行)

评论