今天介紹什麼工具

1. subagent（子代理）:叫別人做事再回報的概念，也可以想成寫程式的執行緒這樣

為什麼要用個工具

1. subagent（子代理）:如果我們把所有的內容都放在單一代理上， Context 容易滿造成注意力不集中，所以有些情況要用子代裡去探索，再把資料代回主代理

如何在 Agy CLI 建立知識庫 Agent

以前 Gemini CLI 有建立一個 cli_help 的 Subagent，專門回答 Gemini CLI 的相關問題，這超讚

結果 Agy CLI 出來後回到解放前，問 Gemini 3.5 Flash 還會得到錯誤的答案，當初 Agy CLI 底層狀態列外掛 是在沒有這兩個 Skills 的情況下做出來的，每次對話大概都要 糾正五次以上才能得到正確的答案或設定，有夠痛苦

後來出了 /antigravity-guide 和 /agy-customizations 這兩個 Skills，兩者差別是

1. antigravity-guide：Antigravity 全產品線的操作方式、介面功能、命令列參數與軟體開發套件
2. agy-customizations：Antigravity 的五大擴充機制（Rules、Skills、Plugins、Hooks、MCP Servers），規範如何撰寫設定檔以改造代理行為

但每次對話都要執行下面指令很麻煩，所以我們來做一個子代理，專門回應 Agy CLI 相關的問題

────────────────────────────────────────────────
> /antigravity-guide /agy-customizations {問問題}
────────────────────────────────────────────────

步驟 1：確認代理目錄與存放位置

在 Antigravity 命令列介面（agy）中，自訂代理採用「資料夾封裝 agent.md」的結構。因為知識庫代理是跨專案通用的工具，我們將它放置在全域設定目錄中：

• 全域設定路徑（推薦）：~/.gemini/config/agents/agy-expert/agent.md
• 專案專用路徑（選用）：<專案根目錄>/.agents/agents/agy-expert/agent.md

步驟 2：編寫代理定義檔（agent.md）

每個自訂代理檔案都由頂部的「前置資料（YAML Frontmatter）」與下方的「系統提示詞（System Prompt）」組成，要注意以下幾點

• subagent: true：最關鍵屬性，宣告此代理可作為子代理在背景被委派執行。
• mainAgent: true：允許在終端機直接透過 agy --agent agy-expert 作為獨立主會話啟動。
• tools：僅配置檔案檢索與網址閱讀工具（view_file、grep_search 等），刻意移除檔案寫入工具，確保查詢作業具備唯讀安全性。

---
name: agy-expert
description: Antigravity CLI (agy) 與客製化體系知識庫專家。專門解答 agy 旗標指令、設定檔結構、以及技能 (Skills)、規則 (Rules)、外掛程式 (Plugins)、掛鉤 (Hooks) 與 MCP 等機制。
mainAgent: true
subagent: true
hidden: false
inheritMcp: true
tools:
  - view_file
  - list_dir
  - grep_search
  - find_by_name
  - read_url_content
  - search_web
commandExecutionPolicy: auto
---

# Antigravity CLI & 客製化體系專家指南

你是 Antigravity 命令列介面的官方知識庫專家。你的任務是精準、客觀地解答開發者對於 Antigravity 的所有疑問。

## 核心知識來源與查閱協議

回答問題前，你不得僅憑記憶推測，必須依循以下協議調用對應的技能（Skill）與官方文件：

### 1. 介面操作、CLI 旗標與基本設定

當問題涉及 `agy` 的指令列參數、斜線指令（Slash Commands）、快速鍵或介面功能時：
- **必查技能**：調用 `/antigravity-guide`。
- **查閱參考**：`antigravity_guide/references/cli.md`、`app.md`。
- **線上查證**：`https://antigravity.google/docs/cli/reference`。

### 2. 客製化架構（Customization System）

當問題涉及 Rules、Skills、Plugins、Hooks、MCP Servers 時：
- **必查技能**：調用 `/agy-customizations`。
- **查閱參考**：`skills.md`、`rules.md`、`plugins.md`、`hooks.md`、`mcp_servers.md`。

---

## 回答原則

1. **路徑與命名精確性**：清楚標註目錄結構（例如技能為 `skills/<name>/SKILL.md`，代理為 `agents/<name>/agent.md`）。
2. **唯讀查詢**：只檢索資訊與給予解答，不對工作區程式碼進行變更。
3. **繁體中文輸出**：使用台灣習慣的技術用語（如：檔案、設定、函式、參數）。

終端機實作

做完 agy-expert Agent 後，有以下幾種實作方法

使用斜線指令呼叫

1. 執行 > /agents 會看到以下介面

   ───────────────────────
   > /agents
   ───────────────────────
   Create New Agents
     Workspace: 專案路徑
     Global: 全域路徑
   
   
   Available Agents
   > ● default  Default agent
       agy-expert  Agy CLI 與客製化體系知識庫專家。
   

2. 切換到 agy-expert 會看到訊息

   > /agents
     ⎿  Prepared selection: agy-expert (will fork the current conversation on exit).
   ───────────────────────
   > 
   ───────────────────────      
   

使用自然語言呼叫

假如我在預設代理要修正 Agy CLI 底層狀態列外掛，可以這樣用

請在背景派工給 agy-expert 去查閱如何設定 Agy CLI 的相關知識，然後修正 OOXX 問題