iT邦幫忙

2026 iThome 鐵人賽

DAY 19
0
Build on Google AI

第一次用 Antigravity CLI 做出 Plugin 就上手系列 第 19

115/19 - antigravity-guide & agy-customizations - 指南和客製化手冊

  • 分享至 

  • xImage
  •  

https://ithelp.ithome.com.tw/upload/images/20260907/20124384dntGypSSNX.jpg

今天介紹什麼工具

  1. antigravity-guide(指南手冊):Antigravity 2.0、CLI、IDE 與 SDK 的離線參考手冊與站台指引。
  2. agy-customizations(客製化文件):Agy CLI 客製化體系的規格指南,詳盡定義了技能(Skills)、規則(Rules)、外掛(Plugins)、掛鉤(Hooks)與 MCP 的底層配置與擴充標準。

為什麼要用這個工具

  1. antigravity-guide(指南手冊):1.0.10 推出
  2. agy-customizations(客製化文件):不知道什麼時候推出

這兩個可以一起說,一開始 Agy CLI 剛出的時候 Gemini 3.5 Flash 沒有 Agy CLI 的相關知識,所以問他 Agy CLI 相關設定只有兩種可能

  1. 已讀亂回,快速回一堆幻覺的東西
  2. 已讀不亂回,去查 Agy CLI 本身的二進制檔案進行逆向工程分析,但就很慢

一開始做 antigravity-cli-statusline 的時候很痛苦,都是邊錯邊查,後來 版出 antigravity-guide(指南手冊)和 agy-customizations(客製化文件)後情況才改善很多,但有時候還是會出現幻覺就是

至於怎麼解決就是後天的內容


終端機實作

1. antigravity-guide(指南手冊)

指令基本語法:

/antigravity-guide

當你在 Antigravity CLI 中對生態系功能有疑問時,可直接在指令後方加上具體問題

/antigravity-guide 請說明 Antigravity CLI 的 settings.json 設定檔有哪些核心欄位?
/antigravity-guide 請給我一段使用 Python SDK 非同步串接 Agent 的標準程式碼。

底層運作流程:Agy CLI 偵測到 /antigravity-guide 觸發,系統會依據提問領域動態查閱對應的離線子手冊(如 references/cli.mdreferences/sdk.md),精準引用官方定義的型別與預設值回答,杜絕無根據的猜測。


2. agy-customizations(客製化文件)

指令基本語法:

/agy-customizations

當你打算為團隊建立自訂義工作流程、撰寫編碼規範,或整合 MCP 伺服器時調用,也可以當做 SKill-Creator 來用

/agy-customizations 我想在專案建立團隊專屬的 Skill,請給我標準的目錄結構與 SKILL.md 範本。
/agy-customizations 請說明在 hooks.json 中如何攔截指令執行(Pre-tool hook)?

底層運作流程:系統啟動客製化體系規格手冊,從 docs/skills.md 提取官方 Frontmatter 規範(包含 name 命名約定、description 第三人生敘述原則),指導你建立具備 scripts/examples/references/ 的高效率漸進式技能。


3. Agy CLI 超好用的功能,一次使用多個斜線指令

Agy CLI 支援多個斜線指令一起調用,使用空格分隔,這樣就能一次呼叫 antigravity-guide 和 agy-customizations

/antigravity-guide /agy-customizations 請幫我規劃一個適用於 Agy CLI 的專屬外掛(Plugin)

但要注意第二個斜線指令無法自動補全,要手動輸入


上一篇
115/18 - generative_ui - 生成 HTML 互動檔案
下一篇
115/20 - Plugins - 外掛架構與 Manifest 配置
系列文
第一次用 Antigravity CLI 做出 Plugin 就上手21
圖片
  熱門推薦
圖片
{{ item.channelVendor }} | {{ item.webinarstarted }} |
{{ formatDate(item.duration) }}
直播中

1 則留言

0
chiaominchang222
iT邦新手 4 級 ‧ 2026-09-07 21:46:32

無法再下任何指令了QQ

我要留言

立即登入留言