結論先說
- Skills(技能)是「按需翻閱的操作手冊」,不同於每輪必讀的 Rules(規則):Antigravity 採用 漸進式披露(Progressive Disclosure) 機制,平時只把每個技能的
name和description放進上下文,命中任務時才去讀完整正文,配額開銷極省。 - 標準存放位置是項目根目錄下的
.agents/skills/<技能名>/SKILL.md:提交進 Git 倉庫即可全團隊共享;只想在自己電腦上全局通用的技能,放進~/.gemini/config/skills/。 SKILL.md頂部的description決定智能體能不能找對時機調用它:官方強烈建議用第三人稱寫清「這個技能做什麼」以及「在用戶提什麼要求時必須激活」。- 長參考資料和複雜命令別全塞進主文件:把幾千字的接口字典拆進同級
references/目錄,把串行 Shell 命令封裝進scripts/目錄,用相對連結按需調用。 - 谷歌帳號準備與主力編程訂閱入口:使用 Antigravity 全系列客戶端需登入符合開放地區與年齡條件的個人谷歌帳號,缺號可查看本站 谷歌帳號購買說明(含帶 2FA 自動發卡的 谷歌電郵成品號);多工具主力開發訂閱總覽見 AI 會員充值中心。

圖:本站根據 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 寫法示範

圖:本站根據 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` 零報錯後再向用戶彙報。
三、怎麼確認技能已生效與排錯要點
寫完儲存後,你可以通過三種辦法確認並調用它:
- 在桌面端面板直觀查看:打開 Antigravity 2.0 左側邊欄的「技能與定製(Skills & Customizations)」,能直接看到當前工作區已成功掃描掛載的自定義技能列表。三種客戶端介面的入口對照見 Google Antigravity 下載與形態介紹。
- 自然語言自動命中或手動點名:只要你的提問匹配
description裏的場景(比如「幫我新增一個退款查詢接口並做契約檢查」),智能體會先自動調用文件讀取工具打開這份SKILL.md,再一步步往下走;你也可以在提示詞裏直接寫出技能名讓它立即加載。 - 非標準目錄用
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。
0 條評論
還沒有評論,來搶沙發~