---
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="/docs/gemini-cli/official/04-agents-skills/40-agent-skills" />
  <Card title="Subagents" description="需要隔离上下文或交给 specialist 时，再进入 subagents。" href="/docs/gemini-cli/official/04-agents-skills/44-subagents" />
  <Card title="Remote agents" description="远端能力涉及网络、认证和数据边界，最后再看。" href="/docs/gemini-cli/official/04-agents-skills/45-remote-agents" />
</Cards>

## 页面清单

| 页面 | 解决的问题 |
| --- | --- |
| [Agent Skills](/docs/gemini-cli/official/04-agents-skills/40-agent-skills) | Skill 生命周期、发现层级和管理命令 |
| [创建 Skills](/docs/gemini-cli/official/04-agents-skills/41-create-skills) | 什么时候该沉淀成 Skill，结构怎么保持小 |
| [Skills 最佳实践](/docs/gemini-cli/official/04-agents-skills/42-skills-best-practices) | description、上下文层级、脚本和失败路径 |
| [激活 Skill](/docs/gemini-cli/official/04-agents-skills/43-activate-skill) | 如何验证 Skill 真的触发和生效 |
| [Subagents](/docs/gemini-cli/official/04-agents-skills/44-subagents) | 专门角色、隔离上下文和委托边界 |
| [Remote agents](/docs/gemini-cli/official/04-agents-skills/45-remote-agents) | A2A、远端认证、数据和安全风险 |

## 下一步

先读：[Agent Skills](/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)
