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、遠端認證、資料和安全風險