Agents & Skills
Gemini CLI Agents & Skills 入口：Agent Skills、创建 skill、最佳实践、激活 skill、subagents 和 remote agents。
Agents & Skills 用来把 Gemini CLI 从“一个通用 agent”扩展成“多个专门能力”。这组能力适合已经跑通基础任务的人，不适合第一次启动就研究。
分层理解：Skills 是专门能力包；Subagents 是专门角色；Remote agents 是远程角色或能力；Hooks 是生命周期自动化，放在集成章节。
学习路径
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。这样后续排错时能判断问题出在发现、激活、委托还是分发。
Agent Skills
先理解 Skill 的生命周期、发现层级和 progressive disclosure。
Subagents
需要隔离上下文或交给 specialist 时，再进入 subagents。
Remote agents
远端能力涉及网络、认证和数据边界，最后再看。
页面清单
| 页面 | 解决的问题 |
|---|---|
| Agent Skills | Skill 生命周期、发现层级和管理命令 |
| 创建 Skills | 什么时候该沉淀成 Skill，结构怎么保持小 |
| Skills 最佳实践 | description、上下文层级、脚本和失败路径 |
| 激活 Skill | 如何验证 Skill 真的触发和生效 |
| Subagents | 专门角色、隔离上下文和委托边界 |
| Remote agents | A2A、远端认证、数据和安全风险 |
下一步
先读：Agent Skills。
章节验收
学完本章后，应该能说清三个问题：这个能力是给当前 agent 加流程，还是交给另一个 agent 做；它会不会读取新的目录；它是否需要用户 consent 或额外信任。说不清时，先不要安装第三方 Skill 或开启 browser agent。
真正上线前，还要用一个小任务跑通：Skill 能触发，Subagent 能隔离上下文，关闭相关能力后 CLI 仍能正常完成基础任务。这样才能证明扩展层不是硬依赖，也方便回退。