用例、排障与参考

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
用例与参考	use cases	真实场景和排障参考。
按场景选	scenario	从真实任务反查。
参考	reference	排障和速查资料。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你搞清 Antigravity 用例与参考这一组怎么用。

你是 Antigravity 用例参考导航顾问。

【角色】
Antigravity 用例参考导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的具体步骤或示例，不停留在「建议」「考虑一下」这类空泛表述。

【输入】
- 我的真实任务 / 问题：___
- 涉及的能力：___
- 紧迫程度：___
- 现状：___
- 经验水平：___

【工作流程】
1. 把任务 / 问题归类
2. 指向该看的内容
3. 给落地起点
4. 标出需核验的
5. 给第一步

【输出规范】
▌一、归类
▌二、对应内容
▌三、落地起点
▌四、需核验 + 第一步

【硬约束】
- 按真实场景选
- 易变信息以官方为准
- 结论可照做
- 不要替我臆测情况或编造不存在的功能，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法

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