---
title: "Agents & Skills"
description: "Gemini CLI Agents & Skills 入口：Agent Skills、建立 skill、最佳實踐、啟用 skill、subagents 和 remote agents。"
verifiedAt: "2026-05-09"
---

Agents & Skills 用來把 Gemini CLI 從“一個通用 agent”擴充套件成“多個專門能力”。這組能力適合已經跑通基礎任務的人，不適合第一次啟動就研究。

> [!NOTE]
> **分層理解**：Skills 是專門能力包；Subagents 是專門角色；Remote agents 是遠端角色或能力；Hooks 是生命週期自動化，放在整合章節。

## 學習路徑

```mermaid
flowchart LR
    Stable["基礎 CLI 穩定"] --> Skill["Agent Skills"]
    Skill --> Create["建立 / 最佳實踐"]
    Create --> Activate["啟用驗證"]
    Activate --> Subagent["Subagents"]
    Subagent --> Remote["Remote agents"]
    Remote --> Runtime["模型與執行時"]

    style Skill fill:#dbeafe,stroke:#3b82f6
    style Subagent fill:#fef3c7,stroke:#f59e0b
    style Remote fill:#fee2e2,stroke:#ef4444
```

## 什麼時候進入這一層

- 你已經能穩定讓 Gemini CLI 讀專案、改小檔案、跑測試。
- 某類任務重複出現。
- 需要把專門流程沉澱成能力包。
- 需要角色分工或遠端 agent。

## 分層邊界

Skill 是目錄裡的說明、指令碼和資源，啟用後給當前 agent 增加一套專門流程。Subagent 是獨立角色，有自己的上下文、工具集和執行配置。Extension 是分發層，可以打包 commands、MCP、主題、上下文和其他能力。

不要用一個概念替代另一個概念：重複流程先考慮 command 或 skill；需要隔離上下文和 specialist 角色再考慮 subagent；需要安裝和分發能力包再考慮 extension。這樣後續排錯時能判斷問題出在發現、啟用、委託還是分發。

<Cards>
  <Card title="Agent Skills" description="先理解 Skill 的生命週期、發現層級和 progressive disclosure。" href="/zh-Hant/docs/gemini-cli/official/04-agents-skills/40-agent-skills" />
  <Card title="Subagents" description="需要隔離上下文或交給 specialist 時，再進入 subagents。" href="/zh-Hant/docs/gemini-cli/official/04-agents-skills/44-subagents" />
  <Card title="Remote agents" description="遠端能力涉及網路、認證和資料邊界，最後再看。" href="/zh-Hant/docs/gemini-cli/official/04-agents-skills/45-remote-agents" />
</Cards>

## 頁面清單

| 頁面 | 解決的問題 |
| --- | --- |
| [Agent Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills/40-agent-skills) | Skill 生命週期、發現層級和管理命令 |
| [建立 Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills/41-create-skills) | 什麼時候該沉澱成 Skill，結構怎麼保持小 |
| [Skills 最佳實踐](/zh-Hant/docs/gemini-cli/official/04-agents-skills/42-skills-best-practices) | description、上下文層級、指令碼和失敗路徑 |
| [啟用 Skill](/zh-Hant/docs/gemini-cli/official/04-agents-skills/43-activate-skill) | 如何驗證 Skill 真的觸發和生效 |
| [Subagents](/zh-Hant/docs/gemini-cli/official/04-agents-skills/44-subagents) | 專門角色、隔離上下文和委託邊界 |
| [Remote agents](/zh-Hant/docs/gemini-cli/official/04-agents-skills/45-remote-agents) | A2A、遠端認證、資料和安全風險 |

## 下一步

先讀：[Agent Skills](/zh-Hant/docs/gemini-cli/official/04-agents-skills/40-agent-skills)。

## 章節驗收

學完本章後，應該能說清三個問題：這個能力是給當前 agent 加流程，還是交給另一個 agent 做；它會不會讀取新的目錄；它是否需要使用者 consent 或額外信任。說不清時，先不要安裝第三方 Skill 或開啟 browser agent。

真正上線前，還要用一個小任務跑通：Skill 能觸發，Subagent 能隔離上下文，關閉相關能力後 CLI 仍能正常完成基礎任務。這樣才能證明擴充套件層不是硬依賴，也方便回退。

## 官方來源

- [Google Developers Gemini CLI](https://developers.google.com/gemini-code-assist/docs/gemini-cli?hl=zh-cn)
- [Gemini CLI GitHub](https://github.com/google-gemini/gemini-cli)
