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 仍能正常完成基礎任務。這樣才能證明擴充套件層不是硬依賴，也方便回退。