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 條評論

登入 後參與評論

還沒有評論,來搶沙發~