为 Antigravity 建立四层事实核验 Agent

一句话结论

该作者把 Gemini 3.8 Flash 用作 Antigravity CLI 的专职问答 Agent agy_help：先查本地结构化手册，再做只读环境检查，必要时抓取官方文档，无法核验就拒答，以减少 CLI 参数、生命周期事件名和 settings.json 配置方面的臆测。

适用场景

• 适合的任务：查询 Antigravity CLI / IDE / Desktop、Python SDK、Skills、Rules、Hooks、Plugins 和 MCP 的配置与用法；需要保持主编码会话上下文干净的后台文档检索。

• 不适合的任务：通用聊天、与 Antigravity 无关的编码任务，以及要求 Agent 修改工作区或执行破坏性命令的任务。

• 适用的模型版本：帖子明确讨论 Gemini 3.8 Flash；没有给出 API 模型 ID 或推理参数配置。

• 适用的客户端、Agent 或 API：Antigravity CLI（agy）、Antigravity IDE / Desktop；通过插件安装 agy_help。

• 推荐的推理档位和参数：原帖未公开推理档位、温度或其他采样参数；不要从该案例推断 API 参数。

可直接使用的内容

安装与验证（原帖文本）

agy plugin install https://github.com/andyawd/antigravity-help-agent

安装后用 agy plugin list 检查插件是否已注册。

四层事实核验工作流

agent: agy_help
verification:
  tier_1_local_reference:
    action: aggregate_and_cross_check
    sources:
      - antigravity_guide
      - agy-customizations
  tier_2_local_inspection:
    mode: read_only
    allowed_commands:
      - agy --help
      - agy changelog
      - agy plugin list
      - pip show google-antigravity
    extra: inspect_local_config_files
  tier_3_official_docs:
    when: offline_reference_is_missing_or_stale
    source: https://antigravity.google/docs
  tier_4_grounded_refusal:
    when: feature_cannot_be_verified
    action: refuse_to_guess
safety:
  workspace_mutation: forbidden
  destructive_commands: forbidden

上面的 YAML 是按原帖四层层级、命令白名单和安全保证整理的可执行工作流定义；命令和文档地址保持原帖所列内容。

四种调用方式（原帖可复制文本）

技能模式，直接在当前会话提问：

/agy_help How do I configure project-level sandbox permissions in Antigravity 2.0 Desktop?

后台子 Agent 委派：

Delegate to the agy_help subagent in the background to look up Antigravity IDE Code Lens configuration and bring back a summary.

切换到专用会话 Agent：

/agents

直接从 CLI 启动：

agy --agent agy_help

测试/工作流步骤

1. 安装插件并运行 agy plugin list，确认 agy_help 已加载。

2. 对 Antigravity 配置问题先使用 /agy_help <问题>；该模式不切换当前主 Agent。

3. 需要保持主会话上下文干净时，使用后台委派，让 agy_help 返回摘要。

4. Agent 先聚合 antigravity_guide 与 agy-customizations，再执行白名单内的只读命令并检查本地配置。

5. 本地资料不足时才访问 https://antigravity.google/docs；仍无法核验的 flag、API 或功能必须明确说明没有官方记录，不得补猜。

6. 对涉及版本、配置层级或生命周期的结论，保留命令输出或官方文档链接，人工复核后再应用。

原始证据与数据

• 原帖作者明确指出，Gemini 3.8 Flash 在编码时可能自信地产生不存在的 CLI flag、错误的生命周期 hook 名称和无效的 settings.json schema；agy_help 是作者为此发布的 Antigravity CLI 插件。

• 作者说明该 Agent 会依次使用本地手册、本地只读诊断、官方文档和“无法核验则拒答”四层机制，并承诺不运行破坏性命令或暗中修改工作区。

• 原帖给出安装命令、CLI 启动命令、技能模式和后台子 Agent 委派示例；因此可以复现“安装 → 查询/委派 → 多层核验 → 摘要或拒答”的工作流，但没有公开 API 请求体、完整 system prompt 或量化准确率实验。

适用边界

• “zero-hallucination”是作者对设计目标的命名，不是经过独立实验验证的零幻觉保证；本地资料错误、版本变化、网络抓取失败仍需人工复核。

• 该方案依赖 Antigravity CLI 的插件、slash command、/agents 和本地文档结构，不能直接当作 Gemini API、Google AI Studio 或其他 IDE 的配置指南。

• Tier 2 的命令虽为只读白名单，仍可能暴露本机版本或配置摘要；共享日志前应脱敏。Tier 3 需要网络，且官方文档发生变化时结果可能不同。

• 原帖没有说明 Gemini 3.8 Flash 的 thinking_level、温度、token 上限或价格，不应把官方 API 文档中的参数套入该 CLI 插件而不做兼容性检查。

来源摘录或观察（仅做合规短引）

作者的核心规则是：如果 flag、API 或功能无法在前面几层核验，“it is strictly forbidden from guessing”。这说明工作流的关键不是堆叠更长的提示词，而是把可验证证据和拒答条件放在 Agent 路由中。