Antigravity Subagents(子代理)怎么配、怎么调:并行探索代码库与隔离上下文实战

让一个主智能体翻遍几十个文件把上下文塞满导致越写越慢?本文按 Google Antigravity 官方文档详解内置 research/self/browser 子代理分工、.agents/agents 自定义角色与多工作树并行机制。

NNathaniel bigo··原创首发·AI 辅助撰写
9 分钟读完
资料核对于 2026-11-18 · 依据官方文档与公开资料整理 Plus 账号

结论先说

  1. 子代理(Subagents)最大的价值不是炫技,而是「保住主对话上下文干净」:让专职子代理去独立会话里翻阅三十个源码文件,最后只把三百字的精炼结论传回主智能体,主窗口既清醒又省后续每步的重复 Token 开销。
  2. 开箱自带三类常用子代理:大范围摸底代码库派 research(只读沙箱)、拆独立模块并行写代码派 self(完整继承工具)、前端点页面验收派 browser。
  3. 多个写代码子代理并行时开启 share 或 branch 工作区隔离:类似 git worktree 共享底层仓库但各自拥有独立工作目录,彻底杜绝两个代理同时改同一份文件互相覆盖。
  4. 固定分工可写成 .agents/agents/ 下的 Markdown 文件随仓库共享:在 Antigravity 2.0 右侧 Subagents 面板或终端敲 /agents 随时查看运行状态。
  5. 账号配套与跨平台编程订阅入口:运行 agy 命令行、SDK 与多子代理并发依赖正常可用的谷歌账号与充裕模型配额,账号准备见本站 谷歌账号说明页,免境外卡开通终端编程会员见 Claude Code 订阅页 与 AI 会员充值总览。

Antigravity 内置子代理角色与分工

图:本站根据 Google Antigravity 官方文档 整理的示意图

本文根据 Google Antigravity 官方文档与子代理功能说明(antigravity.google/docs/cli/features)整理,资料核对于 2026-11-18。配图为本站整理的示意图,不是软件界面截图。本站(bigolab.com)不是 Google 官方网站。

适用于谁

  • 在几百个文件的中大型项目里查问题,一轮全库搜索就把主会话上下文撑爆、导致后续改代码反应变慢的开发者;
  • 想同时让三个智能体分别并行改造三个互不依赖的子模块、又怕它们在同一个目录里抢 Git 锁改冲突的人;
  • 想在仓库里固定配一个「只审安全漏洞不准动代码」的专职审查员角色的人。

一、内置子代理分工与三种工作区隔离模式

当你向主智能体下达复杂任务时,它可以自动拉起后台子代理,也可以在你的明确指示下按角色分工。除了角色权限差异,最关键的工程设计是工作区模式(Workspace Mode):

工作区模式磁盘与分支行为适用子代理任务
inherit(默认继承)直接在主会话当前打开的同一个文件夹里操作只读检索调研(research),或明确串行、无并发写冲突的单任务
share(共享仓库工作树)共享父仓库底层 .git 存储(类似 git worktree),拥有独立工作副本与分支两个以上 self 子代理同时并行编写不同模块,秒级创建且不重复占磁盘
branch(完全隔离克隆)克隆出一份完全独立的隔离工作空间(销毁子代理时同步清理临时目录)高风险重构试错、破坏性依赖升级实验,验证满意后再合并回主线

而且 Antigravity 底层采用响应式唤醒(Reactive Wakeup)机制:主智能体把活派给后台子代理后,不需要写死循环反复轮询「你跑完了没」,闲置等待期间零 Token 消耗;等子代理干完活发回通知,系统会自动唤醒主智能体汇总结果。并行跑多个子代理会同时消耗你账号的模型池额度,配额规划见 Antigravity 额度限制与模型选择;若需准备个人谷歌账号或搭配多平台编码会员,可查看 谷歌账号购买说明 与本站 AI 会员充值总览页。

二、四步自定义团队专属子代理(.agents/agents/)

定义并调用自定义子代理四步

图:本站根据 Antigravity 子代理文档 整理的四步流程示意图

除了内置角色,你还可以把团队常用的专项角色固化在项目的 .agents/agents/(或本机全局 ~/.gemini/config/agents/)目录下。例如新建 .agents/agents/security-auditor.md:

markdown
---
name: security-auditor
description: >-
  安全代码审计专员。当主智能体完成鉴权、支付或文件上传相关代码修改后调用,
  独立审查越权访问、SQL 注入与敏感信息硬编码风险。
---

# 安全审计子代理工作准则

- 你只负责阅读变更文件并输出风险清单,严禁直接修改任何业务源码。
- 重点核查所有新增路由是否挂载了登录态与租户归属校验中间件。
- 按「严重等级 / 文件路径与行号 / 复现路径 / 修复建议」四列格式向主智能体返回报告。

配好之后,日常使用只需简单三步:

  1. 检查挂载状态:在 agy 终端输入 /agents(相关命令汇总见 Antigravity agy 命令行进阶指南),或在 Antigravity 2.0 桌面端右侧辅助面板(Auxiliary Pane)点开 Subagents 标签页确认已识别。
  2. 在提示词里直接点名协同:例如发送「请先派 research 子代理摸清现有支付回调链路,改完代码后再派 security-auditor 独立复核一遍改动」。
  3. 继续追问复用同一子代理会话:如果某个子代理刚查完一整套鉴权逻辑,主智能体可以通过该子代理的会话 ID 直接给它发补充追问,不用重新从零冷启动第二个实例。

常见问题

问:什么时候该用子代理,什么时候直接写一个 Skill(技能)?

答:如果只是教主智能体一套固定操作步骤、且执行过程不会产生海量中间垃圾日志,写 Skill 就够了(见 Antigravity Skills 编写指南);如果是要一口气翻几十个文件找线索、或者要同时开三路并行改不同目录,就必须用子代理隔离上下文与工作树。

问:十几个独立文件都要做同一种机械检查,手点子代理太累怎么办?

答:当任务可以被拆成几十个同构分片(如逐个模块扫描并交叉核验)时,Antigravity 还支持编写动态工作流脚本批量编排并发代理管线,或通过 Python SDK 编程调度,SDK 写法见 Antigravity Python SDK 入门教程。

问:子代理卡死或者跑偏了怎么手动停掉?

答:在 Antigravity 2.0 右侧的 Subagents 面板(或通过主对话管理指令)可以直接查看所有活跃子代理状态并终止指定实例,其历史日志与已生成的工件仍会保留供排查。

问:跑多子代理和终端工具时没有合规谷歌账号或海外信用卡怎么办?

答:可在 本站充值中心 通过支付宝、微信支付或 AlipayHK 即买即发获取 谷歌邮箱成品号,或免上号自助兑换 Claude Pro 自助卡密 与 Claude Max 充值,实时价格与售后边界(封号不在质保范围)以对应商品页为准。

相关教程

Nathaniel 的更多内容

  1. 01

    独立开发者用 ChatGPT + Codex 跑通产品全流程:市场验证、PRD、原型到代码上线复盘清单

    单人做独立产品最容易陷入「闭门写两个月代码上线零用户」或「AI 写到一半目录越改越崩」。本文整理「ChatGPT 负责市场验证、PRD 与复盘 + Codex 负责工程实现与测试」的五阶段双轨流程,附起手提示词与 7 项上线复盘清单。

    ChatGPTCodex0
  2. 02

    用 ChatGPT 批量生成规范文件命名规则、整理混乱目录树与合并零散发票抬头清单脚本

    面对满桌面的「新建文件夹」「最终版2」和上百张零散电子发票,手工改名抄台账耗时又容易漏重。本文分享先脱敏取样、再用 ChatGPT 生成带预演和回滚日志的本地 Python 脚本,离线安全完成目录整理与发票抬头合并去重的实战流程。

    ChatGPT0
  3. 03

    用 ChatGPT 做海外邮件营销(EDM)受众分层文案、A/B 主题行测试与防进垃圾箱自检

    做海外独立站或出海 SaaS 邮件营销(EDM),最怕千人一面群发被直接送进垃圾箱。本文结合 Gmail/Yahoo 批量发件人规范,梳理用 ChatGPT 设计受众分层文案、批量生成 A/B 主题行矩阵并开展发前垃圾词与合规自检的实战提示词。

    ChatGPT0
  4. 04

    用 ChatGPT 写 Notion Formula 2.0 公式、Obsidian Dataview 查询与 Airtable 自动化脚本

    给 Notion 数据库写多条件 Formula 2.0 公式、给 Obsidian 写 Dataview 动态看板,或在 Airtable 里写自动化脚本,经常因为一个小括号或类型不匹配报错半天。本文整理三大工具的通用上下文喂料规范与三套直接可复制的生成提示词。

    ChatGPT其他 AI 工具0
  5. 05

    用 ChatGPT 处理复杂 JSON / YAML / XML 字段映射、格式转换与校验规则编写实战

    对接第三方 API、迁移 Kubernetes 配置或解析政企 XML 报文时,手工对照几百行嵌套字段既慢又容易漏掉空值与类型边界。本文整理用 ChatGPT 完成字段映射表梳理、生成确定性转换脚本以及编写 JSON Schema / Pydantic / XSD 校验规则的实战流。

    ChatGPT其他 AI 工具0
  6. 06

    用 ChatGPT 准备本科/硕士毕业论文答辩:提炼答辩 PPT 结构、模拟导师犀利追问与 3 分钟自述稿

    毕业论文写完后,要在 3–5 分钟内讲清研究价值并顶住答辩评委的连环追问并不轻松。本文整理在严格遵守高校学术规范的前提下,用 ChatGPT 提炼答辩 PPT 结构、打磨 3 分钟口语自述稿并开展模拟导师犀利追问的排练流程与提示词。

    ChatGPT0

同模型

  1. 01

    用 Google Takeout 单独备份导出 NotebookLM 笔记本与 Gemini 记录:只勾选指定服务不下载整个云端硬盘的步骤

    想把 NotebookLM 里的几十个研究笔记本、来源副本与音频概览,连同 Gemini 聊天记录一起备份到本地,又怕 Google Takeout 把整个云端硬盘和相册全打包?本文讲清先取消全选、精准勾选两项服务、解压目录查看与跨号迁移的做法。

    Gemini0
  2. 02

    Google Workspace 企业/教育版管理员怎么在后台给成员开启 Gemini 应用、NotebookLM 与设置年龄访问权限

    团队成员或学校师生登录 Google Workspace 账号时提示无权使用 Gemini 或打不开 NotebookLM?本文按 Google 管理控制台官方文档整理服务开关路径、组织部门(OU)与群组放行、18 岁年龄访问权限设置及对话保留合规配置。

    Gemini0
  3. 03

    安卓手机默认助手换成 Gemini 后设闹钟、发短信或控制智能家居失灵怎么办:Workspace 与实用程序扩展开启步骤

    安卓手机把默认语音助手从 Google Assistant 换成 Gemini 后,喊它定闹钟、开手电筒、发短信或开关智能灯全都没反应?本文按官方帮助中心整理实用程序(Utilities)、Google Home 与 Workspace 关联应用开启步骤及锁屏放行设置。

    Gemini0
  4. 04

    Gemini 写长代码或长文档到一半突然停住、格式截断怎么无缝续写:锚点接续指令与 Canvas 分块修改技巧

    让 Gemini 写几百行代码或万字长文时经常写到一半突然停住、Markdown 代码块没闭合,直接回「继续」又重头抄一遍?本文整理字面锚点续写指令、代码块防乱码补齐法与 Canvas 局部圈选修改工作流。

    Gemini0
  5. 05

    NotebookLM 中文音频播客(Audio Overview)高阶玩法:用自定义引导词控制对谈深度、受众水平与重点章节(附模板)

    NotebookLM 生成的中文音频播客总是泛泛而谈、漏掉核心章节或夹杂生僻英文缩写?本文按官方帮助中心整理来源勾选过滤、四种播客格式搭配与三维自定义引导词写法,附 4 套可直接复制的中文控场模板。

    Gemini0
  6. 06

    NotebookLM 添加 YouTube 视频、网页或扫描版 PDF 提示「无法导入来源」怎么办:无字幕、反爬与纯图 PDF 逐项解决

    往 NotebookLM(Gemini Notebook)塞 YouTube 链接、外文网页或扫描教材时总是亮红叹号提示无法导入来源?本文按官方帮助中心逐项排查无字幕视频、反爬动态页与加密纯图 PDF 的替代导入步骤。

    Gemini0

同产品的其他教程

  1. 01

    用 ChatGPT 速读英文产品手册、开源文档与 GitHub Issue 并沉淀团队中文内训手册

    团队引入海外 SaaS 工具或开源框架时,全英文文档晦涩冗长、真正的坑全藏在几十页 GitHub Issue 讨论里。本文分享速读拆解英文手册、归类 Issue 排障库以及重构团队中文内训 SOP 的完整实战流程。

    ChatGPT其他 AI 工具0
  2. 02

    用 ChatGPT 写油猴脚本(Tampermonkey)与浏览器书签小工具解决网页繁琐重复操作实战

    每天在后台系统里重复勾选几十个复选框、手工复制网页表格或清理遮挡阅读的侧边栏,既枯燥又浪费时间。本文分享不会写 JS 也能用 F12 配合 ChatGPT 写出油猴脚本与书签小工具的完整实战流程。

    ChatGPT其他 AI 工具0
  3. 03

    用 ChatGPT 写高质量 SQL 窗口函数(RANK / LAG / SUM OVER)做留存与漏斗分析实战

    做用户留存率、复购间隔与有序转化漏斗时,多层自连接既难读又拖垮数据库,窗口函数则是高效解法。本文整理数据库方言喂数规范、CTE 分层提示词以及用内置沙盒先验证再上线的完整实战流程。

    ChatGPT其他 AI 工具0
  4. 04

    ChatGPT 连接 Canva、Figma、Linear、Jira、Dropbox 等第三方应用搜不到数据或授权失效怎么办

    在 ChatGPT 接入 Canva、Figma、Linear、Jira 或 Dropbox 后,明明显示已连接却搜不到文件工单,或老提示授权失效怎么办?本文拆解账号错绑、OAuth 范围漏选、权限继承与管理员拦截 5 步排障法。

    ChatGPT其他 AI 工具0
  5. 05

    Anthropic Contextual Retrieval(上下文增强检索)是什么、怎么实现:给文档块自动补背景摘要结合缓存降失误率

    长文档切成小块后丢了公司名、年份和主语指代导致 RAG 频频搜错?本文按 Anthropic 官方技术文章详解 Contextual Retrieval 原理、官方公开评测失误率下降 49% 至 67% 的组合架构,以及用 Claude 提示词缓存低成本批量生成切片背景的完整 Python 代码。

    Claude其他 AI 工具0
  6. 06

    RAG 知识库回答不准怎么调优:切片大小(Chunking)、BM25 + 向量混合检索与 Rerank 重排序三步排查法

    搭好的 RAG 企业知识库一问具体型号、报错码或跨行表格就答非所问?本文按 OpenAI 与 Anthropic 官方检索文档,给出先隔离检索与生成故障、再按结构化切片(Chunking)、BM25 加向量混合召回(RRF)与 Rerank 重排序逐层调优的三步法。

    Claude其他 AI 工具0

0 条评论

登录 后参与评论

还没有评论,来抢沙发~