背景
Repository 已同時提供 Codex 與 Antigravity manifests,但目前 README 尚未完整說明 Antigravity CLI 使用者應如何驗證、安裝及呼叫各個 plugin。
Codex 的 .agents/plugins/marketplace.json 不是 Antigravity CLI marketplace;Antigravity CLI 的安裝單位是各個 plugins/<name> 目錄,而不是 repository root。以 Antigravity CLI 1.1.18 實測:
agy plugin validate ./plugins/cmd -> OK,處理 8 個 skills
agy plugin validate ./plugins/dev -> OK,處理 1 個 skill
agy plugin validate . -> 失敗,repository root 沒有 plugin.json
目標
在 README 補上一節完整且經過實測的「Antigravity CLI 安裝與使用」,讓使用者不需要理解 Codex marketplace 結構也能正確使用 cmd 與 dev。
文件應涵蓋
-
說明 Codex 與 Antigravity 的入口差異:
- Codex:
plugins/<name>/.codex-plugin/plugin.json
- Antigravity CLI:
plugins/<name>/plugin.json
.agents/plugins/marketplace.json 僅供 Codex marketplace 使用。
-
說明 workspace 載入與全域安裝的差別:
- 驗證
.agents/plugins.json 在目前支援的 Antigravity CLI 版本中,是否會於 workspace 自動載入 plugins/。
- 若不會,修正 README 的既有敘述,不要宣稱 CLI 會自動載入。
- 若要在其他 projects 使用,應逐個安裝 plugin。
-
提供可複製執行的驗證與安裝指令:
agy plugin validate ./plugins/cmd
agy plugin validate ./plugins/dev
agy plugin install ./plugins/cmd
agy plugin install ./plugins/dev
agy plugin list
-
列出安裝後的主要 slash commands:
cmd:/commit、/commit-push、/commit-push-pr、/create-branch、/fix-pr、/grill-on-point、/pr、/push
dev:/sdkman-switch-jdk
-
補上 enable、disable、uninstall 的基本操作。
-
說明必要環境與相依項目:
- Git/GitHub CLI 與登入狀態。
sdkman-switch-jdk 需要 POSIX shell 與 SDKMAN。
cmd 部分 workflows 會呼叫未封裝在 plugin 內的 skills,例如 git-commit-co-author、grill-with-docs、grilling、domain-modeling;文件需說明如何取得,或明確標示不是獨立安裝即可完整運作。
-
說明 agents/openai.yaml 是 Codex/OpenAI UI metadata,Antigravity CLI 主要載入 SKILL.md,不應把該 metadata 當成跨平台保證。
驗收條件
非目標
- 本 issue 不新增一鍵安裝器。
- 本 issue 不重寫現有 skills。
- 本 issue 不建立新的 Antigravity marketplace 格式。
背景
Repository 已同時提供 Codex 與 Antigravity manifests,但目前 README 尚未完整說明 Antigravity CLI 使用者應如何驗證、安裝及呼叫各個 plugin。
Codex 的
.agents/plugins/marketplace.json不是 Antigravity CLI marketplace;Antigravity CLI 的安裝單位是各個plugins/<name>目錄,而不是 repository root。以 Antigravity CLI 1.1.18 實測:目標
在 README 補上一節完整且經過實測的「Antigravity CLI 安裝與使用」,讓使用者不需要理解 Codex marketplace 結構也能正確使用
cmd與dev。文件應涵蓋
說明 Codex 與 Antigravity 的入口差異:
plugins/<name>/.codex-plugin/plugin.jsonplugins/<name>/plugin.json.agents/plugins/marketplace.json僅供 Codex marketplace 使用。說明 workspace 載入與全域安裝的差別:
.agents/plugins.json在目前支援的 Antigravity CLI 版本中,是否會於 workspace 自動載入plugins/。提供可複製執行的驗證與安裝指令:
列出安裝後的主要 slash commands:
cmd:/commit、/commit-push、/commit-push-pr、/create-branch、/fix-pr、/grill-on-point、/pr、/pushdev:/sdkman-switch-jdk補上 enable、disable、uninstall 的基本操作。
說明必要環境與相依項目:
sdkman-switch-jdk需要 POSIX shell 與 SDKMAN。cmd部分 workflows 會呼叫未封裝在 plugin 內的 skills,例如git-commit-co-author、grill-with-docs、grilling、domain-modeling;文件需說明如何取得,或明確標示不是獨立安裝即可完整運作。說明
agents/openai.yaml是 Codex/OpenAI UI metadata,Antigravity CLI 主要載入SKILL.md,不應把該 metadata 當成跨平台保證。驗收條件
cmd與dev安裝後能在/skills中找到預期 skills,並至少各完成一次不造成外部副作用的 smoke test。非目標