用例、排障与参考

Antigravity 最适合的不是“随便帮我写点代码”，而是有明确目标、有可验收路径、需要跨 editor、terminal 和 browser 的开发任务。官方发布文给出的典型方向包括复杂多工具任务、UI 迭代和后台长任务维护。

判断标准：如果任务可以用 plan、diff、test、screenshot、browser recording 和 walkthrough 证明完成，它就更适合 Antigravity。

1. 适合的任务

任务	为什么适合
修复 UI bug	可以改代码、启动服务、打开浏览器、截图/录屏验证
给已有功能补测试	可以读代码、生成测试、跑命令、交付结果
小到中等范围重构	可以先 plan，再逐步 diff review
文档重组	可以生成 task list、批量改文件、交付 walkthrough
依赖升级排障	可以查 terminal 输出、改配置、跑测试
多页面交互验证	Browser Subagent 可以点击、输入、观察页面

2. 不适合直接交给 agent 的任务

任务	风险	更好的方式
生产数据库改动	不可逆、影响真实用户	先写迁移计划，人工执行
账号后台操作	登录态和权限风险	人工操作，agent 只做只读指导
密钥轮换	可能泄露凭据	用内部 SOP，不让 agent 接触明文
大范围无边界重构	diff 无法审完	拆成模块级任务
涉及付款/广告投放	金钱和合规风险	人工审批和操作

3. 排障顺序

flowchart TD
    Symptom["出现问题"] --> Layer{"先定位层级"}
    Layer --> Install["安装 / 登录"]
    Layer --> Workspace["Workspace / file access"]
    Layer --> Permission["Permissions / sandbox"]
    Layer --> Browser["Browser extension / URL allowlist"]
    Layer --> Model["模型 / quota / pricing"]
    Layer --> Project["项目依赖 / 测试命令"]
    Project --> Evidence["保留日志、diff、artifact"]
    Evidence --> Feedback["必要时通过应用内反馈入口报告"]

不要一上来重装。先判断是安装、登录、权限、浏览器、模型额度，还是项目本身的问题。

4. 常见症状

症状	优先检查
agent 不跑命令	Terminal Execution policy、Allow/Deny/Ask、sandbox
agent 看不到文件	workspace 是否正确、file access 是否限制
浏览器任务卡住	浏览器扩展、URL allowlist、JavaScript policy
没有 screenshot 或 recording	prompt 是否要求 browser 验收，任务是否进入 Browser Subagent
修改范围太大	prompt 边界、Planning plan、workspace 是否过宽
模型不可用	官方 pricing / quota / model selector