Antigravity Skills 技能怎么写、怎么加载:.agents/skills 目录与渐进式披露机制

在 Google Antigravity 里怎么把复杂的团队发版流程、代码生成模板封装成随叫随到的技能?本文按官方文档拆解 .agents/skills 目录结构、SKILL.md 必填元数据与省 Token 的渐进式披露机制。

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

结论先说

  1. Skills(技能)是「按需翻阅的操作手册」,不同于每轮必读的 Rules(规则):Antigravity 采用 渐进式披露(Progressive Disclosure) 机制,平时只把每个技能的 name 和 description 放进上下文,命中任务时才去读完整正文,配额开销极省。
  2. 标准存放位置是项目根目录下的 .agents/skills/<技能名>/SKILL.md:提交进 Git 仓库即可全团队共享;只想在自己电脑上全局通用的技能,放进 ~/.gemini/config/skills/。
  3. SKILL.md 顶部的 description 决定智能体能不能找对时机调用它:官方强烈建议用第三人称写清「这个技能做什么」以及「在用户提什么要求时必须激活」。
  4. 长参考资料和复杂命令别全塞进主文件:把几千字的接口字典拆进同级 references/ 目录,把串行 Shell 命令封装进 scripts/ 目录,用相对链接按需调用。
  5. 谷歌账号准备与主力编程订阅入口:使用 Antigravity 全系列客户端需登录符合开放地区与年龄条件的个人谷歌账号,缺号可查看本站 谷歌账号购买说明(含带 2FA 自动发卡的 谷歌邮箱成品号);多工具主力开发订阅总览见 AI 会员充值中心。

Skills 技能与 Rules 规则的核心区别

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

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

适用于谁

  • 想把团队内部的发版清单、数据库迁移流程或组件脚手架教给 Antigravity 反复复用的开发者;
  • 发现 GEMINI.md 越写越臃肿、挤占常驻上下文预算,想把长篇手册改成按需读取的人;
  • 原先在旧版 Gemini CLI 写过技能,想确认在 Antigravity IDE 与 2.0 桌面端里怎么组织目录的人。

一、什么时候写 Skill,什么时候写 Rule

不少团队刚开始定制工作区时,容易把所有文档一股脑全塞进 GEMINI.md。对照我们在 Antigravity Rules 规则与 24KB 预算裁剪机制 里讲过的限制,常驻规则共用 2 万 Token 预算,放太多低频 SOP 会直接挤占正常对话空间。按官方划分标准:

  • 该写成 Rule 的内容:任何时候写代码都不能破的底线(例如「一律用 pnpm」「禁止改已上线的迁移文件」);
  • 该写成 Skill 的内容:分步骤的标准作业程序(例如「新增后台 CRUD 接口五步流程」「上线前安全自检步骤」「把国际化文案同步成多语种 JSON 的脚本调用方法」)。

此前如果你看过旧版命令行的 Gemini CLI Skills 安装与创建教程,好消息是 Antigravity 完整保留了这套以 SKILL.md 为核心的设计,并在 IDE、2.0 桌面端与 agy 命令行三端打通。如果还没配置好谷歌开发账号,可先浏览 谷歌账号购买与首登指南 或查看自动发卡的 谷歌邮箱成品号详情页(质保口径以商品页说明为准)。

二、标准目录结构与 SKILL.md 写法示范

编写并加载自定义 Skill 四步流程

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

一个规范的自定义技能必须是 skills/ 下的一个独立文件夹(文件夹名与技能名推荐统一用小写英文加连字符),内部结构如下:

text
.agents/skills/api-contract-check/
├── SKILL.md          # 必填:含顶部 YAML 元数据与主步骤说明
├── scripts/          # 可选:供智能体直接调用的辅助脚本(如校验脚本)
├── examples/         # 可选:标准输出范例或参考实现代码
├── resources/        # 可选:代码模板或静态配置文件
└── references/       # 可选:体积较大的详细规范(仅在需要时读取)

打开 SKILL.md,顶部必须包含 name 和 description 两个 YAML 字段。下面是一个可直接放进仓库复用的后端接口自检技能模板:

markdown
---
name: api-contract-check
description: >-
  当用户要求新增、修改后端 REST 接口或排查前后端字段不一致时使用本技能。
  负责执行 OpenAPI 契约比对、生成前端类型定义并运行接口冒烟测试。
---

# 后端接口契约核验工作流

修改或新增路由代码后,请严格按以下顺序执行并核验:

## 执行步骤

1. 阅读错误码约定(仅在新增报错分支时查阅):
   [错误码字典](./references/error-codes.md)
2. 运行本地契约导出与比对脚本:
   `bash .agents/skills/api-contract-check/scripts/check-openapi.sh`
3. 同步更新前端 TypeScript 类型文件:
   `pnpm run gen:types`
4. 验证标准:确认终端输出 `0 breaking changes` 且 `pnpm typecheck` 零报错后再向用户汇报。

三、怎么确认技能已生效与排错要点

写完保存后,你可以通过三种办法确认并调用它:

  1. 在桌面端面板直观查看:打开 Antigravity 2.0 左侧边栏的「技能与定制(Skills & Customizations)」,能直接看到当前工作区已成功扫描挂载的自定义技能列表。三种客户端界面的入口对照见 Google Antigravity 下载与形态介绍。
  2. 自然语言自动命中或手动点名:只要你的提问匹配 description 里的场景(比如「帮我新增一个退款查询接口并做契约检查」),智能体会先自动调用文件读取工具打开这份 SKILL.md,再一步步往下走;你也可以在提示词里直接写出技能名让它立即加载。
  3. 非标准目录用 skills.json 注册:如果你的多个仓库共用外部某个统一目录里的技能包,不想每个仓库都复制一遍 .agents/skills/,可以在工作区通过 skills.json 显式声明外部路径,优先级仅次于工作区本地发现。配合按需加载技能还能显著延长高频编码周期,更多省额度办法见 Antigravity 额度限制与模型选择。

常见问题

问:写好了 SKILL.md,为什么我提问时智能体根本没去读它?

答:九成原因是顶部的 description 写得太抽象(比如只写了「后端开发助手」)。把它改成具体的触发动作描述(例如「当用户要求新建数据库迁移文件或修改 Prisma schema 时调用」),命中率会立刻提升。

问:工作区 .agents/skills/ 和全局 ~/.gemini/config/skills/ 有同名技能时听谁的?

答:按官方加载优先级,工作区项目目录优先级高于本机全局目录。同名时工作区版本会自动覆盖全局版本,方便针对个别老项目定制特殊脚本。

问:SKILL.md 里能写通用编程常识吗?

答:官方明确建议不要写模型本来就懂的基础语法常识。主文件越精炼、验证成功标准(Validation Steps)越明确,智能体执行时的走偏概率越低。

问:国内没有可用的个人谷歌账号,或者重度写代码想搭配其他编程订阅怎么办?

答:可在本站即时选购带独立 2FA 的 谷歌邮箱成品号(首登顺序与 3 天首登质保细则见 谷歌账号购买页),支持支付宝、微信支付与 AlipayHK;若日常还需要高配额终端智能体互补,也可自助兑换 Claude Code 订阅 或 ChatGPT Plus。

相关教程

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 条评论

登录 后参与评论

还没有评论,来抢沙发~