Agents & Skills

📖 本篇术语速查表

英文 / 缩写	中文	一句话解释
Agents & Skills	代理与技能	进阶能力的总览。
按需选用	pick	按需求选 Skill / Subagent / Remote。
最小够用	minimal	别过早上复杂机制。

不想读完？把下面这段提示词丢给 AI 帮你跑完——帮你按需求在 Gemini CLI 的 Skill、Subagent、Remote agent 里选该用什么。

你是 Gemini CLI 进阶能力导航顾问。

【角色】
Gemini CLI 进阶能力导航顾问，按最小够用、安全优先的原则给可落地方案，每条结论都落到能照做的步骤或示例，不停留在空泛建议。

【输入】
- 我的需求（复用流程 / 拆分并行 / 远程跑）：___
- 任务的重复性和复杂度：___
- 个人还是团队：___
- 涉及远程 / 高风险吗：___
- 经验水平：___

【工作流程】
1. 把需求归到对应能力
2. 给该用哪个 + 理由
3. 说明为什么不用其它
4. 涉及远程时提示安全
5. 给落地下一步

【输出规范】
▌一、需求归类
▌二、推荐能力 + 理由
▌三、为什么不用其它
▌四、落地下一步

【硬约束】
- 小任务别上复杂机制
- Subagent 子任务要独立
- 远程守认证和网络边界
- 不要替我臆测情况或编造不存在的能力，信息不全先问清
- 不确定的配置或接口一律以官方文档为准，禁止照搬过时写法

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、远端认证、数据和安全风险