代理技能

技能是 開放標準 用來擴充代理 功能。技能是包含 的資料夾 SKILL.md 檔案含代理在處理特定任務時可遵循的 指示。

什麼是技能？

技能是可重複使用的知識套件，可擴展代理的能力。 每個技能包含：

• 指示：關於如何處理特定任務的明確協定。
• 最佳實務：要遵循的慣例、風格指南與檢查清單。
• 指令碼與資源：代理可執行的 選用輔助指令碼與資料結構描述。

當您開始對話時，代理會看到可用技能的清單及其名稱與說明。若某個技能看似與您的任務相關，代理會閱讀完整指示並遵循。

備註

備註：Antigravity 預設為 .agents/skills，但仍維持對…的回溯 相容性 .agent/skills.

技能剖析

技能以目錄套件的形式組織，包含必要的 SKILL.md 檔案：

my-skill/
├── SKILL.md       # Required skill instructions and metadata
├── scripts/       # Optional executable scripts
├── examples/      # Optional reference implementations
└── resources/     # Optional templates, schemas, or data files

資訊清單格式（SKILL.md)

每個 SKILL.md 檔案開頭是定義其名稱與 觸發條件的 YAML frontmatter：

---
name: code-review
description: Reviews code changes for bugs, style issues, and best practices. Use when reviewing pull requests or checking code quality.
---

# Code Review Skill

When reviewing code, follow these steps:

## Review checklist

1. **Correctness**: Verify that the code satisfies specifications.
2. **Edge cases**: Ensure error conditions and boundaries are handled.
3. **Style**: Follow project naming and architectural patterns.
4. **Performance**: Identify potential bottlenecks or inefficiencies.

Frontmatter 欄位

YAML 前置資訊支援下列欄位：

欄位	必要	描述
name	否	技能的唯一識別碼（小寫，空格以連字號取代）。若未提供，預設為資料夾名稱。
description	是	清楚描述技能的功能與使用時機。這是代理決定是否套用該技能時所看到的內容。

提示

以第三人稱撰寫描述，並加入能幫助代理辨識技能適用時機的關鍵字。例如：「Generates unit tests for Python code using pytest conventions.」

代理如何使用技能

技能遵循 漸進式揭露 模式：

1. 探索：對話開始時，代理會看到可用 技能的清單，包含其名稱與描述。
2. 啟用：若技能看似與您的任務相關，代理會讀取 完整的 SKILL.md 內容。
3. 執行：代理在處理 您的任務時會遵循技能的指示。

您不需要明確告訴代理使用技能——它會根據情境自行決定。不過，若您想確保使用某個技能，可以直接提及該技能的名稱。

最佳實務

保持技能聚焦

每個技能都應專注做好一件事。與其建立「包山包海」的技能，不如為不同任務建立各自獨立的技能。

撰寫清晰的描述

描述是代理決定是否使用您技能的依據。請具體說明技能的功能與適用時機。

將指令碼作為黑箱使用

若您的技能包含指令碼，請鼓勵代理使用執行它們 --help 先閱讀，而非閱讀整個原始碼。這能讓代理的上下文 專注於任務。

包含決策樹

對於複雜的技能，新增一個區段，協助代理依情境選擇正確的方法 。

依介面區分的技能

探索如何在您偏好的介面上建立與管理技能：

Antigravity 應用程式

Antigravity 應用程式

Antigravity 應用程式技能位置

Antigravity App 會從兩個主要位置載入技能：

位置	範圍
<workspace-root>/.agents/skills/<skill-folder>/	工作區專用
~/.gemini/config/skills/<skill-folder>/	全域（所有工作區）

每個範圍各有不同的用途：

• 工作區技能：範圍限於單一專案，並提交至版本 控制以跨工程團隊共用。
• 全域技能：適用於您工作站上的所有專案。

在 Antigravity 應用程式中呼叫技能

您可以透過兩種方式在 Antigravity 應用程式中呼叫技能：

• 自主呼叫：代理會根據您的提示詞自動讀取並遵循相關 技能。
• 手動斜線指令：輸入 /<skill-name> 於提示詞面板 明確呼叫技能。

Antigravity CLI

Antigravity CLI

CLI 技能位置

Antigravity CLI 完整支援本機與全域代理技能：

位置	範圍
<workspace-root>/.agents/skills/<skill-folder>/	工作區專用
~/.gemini/antigravity-cli/skills/<skill-folder>/	全域（所有工作區）
~/.gemini/antigravity-cli/plugins/<name>/skills/	外掛程式提供的技能

斜線指令轉換

每當您定義技能時，CLI 自動將其轉換為斜線指令 於互動式 TUI 內部。例如，建立名為 的技能 deploy-staging 立即使 /deploy-staging 可在提示框中使用。

使用外掛管理技能

技能也可以打包在外掛程式中，並透過下列方式管理 agy plugin:

# List installed plugins (pass --json to include bundled skill names and paths)
agy plugin list
agy plugin list --json

# Install a plugin from the official marketplace (defaults to @antigravity-plugins-official)
agy plugin install <plugin-name>

# Install a skill bundle from a GitHub URL or local plugin path
agy plugin install https://github.com/<owner>/<repo>
agy plugin install ./my-skills-plugin

Antigravity IDE

Antigravity IDE

Antigravity IDE 技能位置

在獨立的 Antigravity IDE 中，技能從以下位置探索：

位置	範圍
<workspace-root>/.agents/skills/<skill-folder>/	工作區專用
~/.gemini/config/skills/<skill-folder>/	全域（所有工作區；舊版 ~/.gemini/antigravity/skills/ 亦支援）

您可以從以下位置檢視所有啟用中的技能 自訂項目 選單，於代理 側邊面板。