# 影片筆記：ClaudeCode里的专职AI员工 -Subagent详解 【第八讲】

## 一句話總結
本講解介紹了如何在 Cloud Code 中使用 Subagents（子代理），將其比喻為專職員工，透過獨立窗口執行任務以節省主窗口上下文，並根據任務類型（研究、審查、執行）配置不同模型與權限，實現高效、安全且具成本效益的自動化工作流。

## 核心重點
1.  **架構比喻**：將 Cloud Code 比作公司副總裁，Subagents 比作執行特定專項任務的員工。
2.  **核心優勢**：
    *   **上下文隔離**：Subagents 在獨立窗口中執行任務，不佔用主對話窗口的上下文（Context），避免主窗口被擠爆。
    *   **結果匯報**：任務完成後僅將結果返回主窗口，保持主對話清爽。
3.  **三大特點**：
    *   **專職專能**：專注單一任務以提升品質。
    *   **權限控制**：可配置單獨的工具權限，防止誤操作（如誤寫重要文件）。
    *   **成本優化**：根據任務難度選擇模型。複雜任務使用高智商模型（Opus, Sonet），簡單任務使用快速模型（Hiku）。
4.  **Subagents 類型**：
    *   **研究型**：大量讀文件、搜代碼、查文檔，輸出報告（例：研究 GitHub 項目、扒競品網站）。
    *   **審查型**：Code Review、找 Bug、安全審查、合規檢查。
    *   **執行型**：直接改代碼、跑命令（例：修 Bug、寫測試、跑數據上線）。
5.  **創建與管理**：
    *   支持自然語言描述自動生成（推薦新手）或使用 `-agents` 命令手動設定。
    *   調用方式包括自然語言描述或 `Gong Agents` 命令精確調用。
    *   管理功能包含查看、編輯（工具、模型、背景色）及刪除。

## 詳細大綱

### 1. Subagents 概念與價值
*   **角色定位**：
    *   人類 = 總裁
    *   Cloud Code = 副總裁
    *   Subagents = 員工
*   **運作機制**：
    *   複雜任務被拆解。
    *   在獨立窗口中完成任務。
    *   僅將結果返回主窗口。
*   **主要好處**：
    *   避免佔用主窗口上下文。
    *   避免上下文被擠爆。
    *   保持主對話效率。

### 2. Subagents 顯著特點
*   **專職專能**：專注單一任務以提升品質。
*   **權限控制**：
    *   配置單獨工具權限。
    *   防止誤操作（如誤寫重要文件）。
    *   文中提及「防止不同的 Subagents 月權去避免一些風險」（疑點：月權）。
*   **成本優化**：
    *   複雜任務：使用高智商模型（Opus, Sonet）。
    *   簡單任務：使用快速模型（Hiku）。

### 3. Subagents 結構與類型
*   **必要組成要素**：
    *   名字
    *   基礎描述
    *   可用工具
    *   使用的模型
    *   工作 Prompt
*   **三種類型詳解**：
    1.  **研究型**：
        *   行為：大量讀文件、搜代碼、查文檔。
        *   輸出：報告。
        *   案例：研究 GitHub 項目、扒競評的网站（疑點：競評）。
    2.  **審查型**：
        *   行為：Code Review、找 Bug、安全審查、合規檢查。
    3.  **執行型**：
        *   行為：直接改代碼、跑命令。
        *   案例：修 Bug、写测试用力（疑點：用力）、跑数据上线（疑點：跑步数）。

### 4. 創建 Subagents
*   **方式一：自然語言描述**
    *   推薦給新手。
    *   讓 Cloud Code 自動生成。
*   **方式二：命令列創建**
    *   使用 `-agents` 命令調起創建流程。
    *   手動設定：
        *   位置
        *   用途
        *   權限
        *   模型
        *   背景色

### 5. 調用 Subagents
*   **方式一：自然語言描述**
    *   描述任務。
    *   可附帶網址等資訊。
*   **方式二：命令列精確調用**
    *   使用 `Gong Agents` 命令。
    *   進入 Library 選擇特定 Agent。

### 6. 管理 Subagents
*   **進入管理介面**：
    *   使用 `Gong Agents` 命令進入 Library。
    *   查看所有存在的 Subagent。
*   **管理選項**：
    *   View（查看）
    *   Edit（編輯）
    *   Delete（刪除）
*   **編輯選項**：
    *   在編輯器直接編輯。
    *   調整工具權限。
    *   調整 Model。
    *   修改背景色。
*   **自然語言管理**：
    *   讓 Cloud Code 列出列表。
    *   執行編輯或刪除操作。

## 工具 / 模型 / 名詞整理
*   **產品/平台**：Cloud Code
*   **功能/機制**：Subagents
*   **模型名稱**：
    *   Opus
    *   Sonet
    *   Hiku
*   **命令/接口**：
    *   `-agents`
    *   `Gong Agents`
    *   `Library`
    *   `View`
    *   `Edit`
    *   `Delete`
*   **文件類型**：MD 文檔
*   **其他專有名詞**：
    *   GioHunter（文中提及作為 Subagent 名稱範例）
    *   Gio（文中提及作為研究對象範例，如 "Gio策略"、"Gio研究"）
    *   Code Review
    *   Token
    *   Prompt

## 操作流程整理
1.  **創建 Subagent**：
    *   選項 A：使用自然語言描述任務，由 Cloud Code 自動生成。
    *   選項 B：輸入 `-agents` 命令，手動設定名稱、描述、工具權限、模型及背景色。
2.  **調用 Subagent**：
    *   選項 A：在對話中直接使用自然語言描述任務（可包含網址）。
    *   選項 B：輸入 `Gong Agents` 命令，進入 Library 選擇已存在的特定 Agent。
3.  **管理 Subagent**：
    *   輸入 `Gong Agents` 命令進入 Library。
    *   選擇目標 Subagent 進行 View、Edit 或 Delete。
    *   在 Edit 模式下，可調整工具權限、模型或背景色。
    *   或直接使用自然語言要求列出列表、編輯或刪除。

## 值得注意的限制或風險
*   **上下文管理**：若未正確使用 Subagents，主對話窗口上下文可能被擠爆，影響效率。
*   **權限風險**：若未正確配置 Subagents 的工具權限，可能存在誤操作風險（如誤寫重要文件）。
*   **模型選擇**：需根據任務難度選擇合適模型，錯誤選擇可能影響成本或效率。

## 逐字稿辨識疑點
*   **GioHunter / Gio**：逐字稿中多次出現「GioHunter」及「Gio策略」、「Gio研究」。在常見開發工具或 AI 模型語境中，此詞彙較為陌生，疑似為特定內部工具名稱、口誤或聽寫錯誤（例如是否為 "Go"、"GitHub" 或其他特定專案名稱的誤聽）。
*   **Sonet**：模型名稱通常常見拼寫為 "Sonnet"，逐字稿記為 "Sonet"，標記為需查證。
*   **Hiku**：模型名稱通常常見拼寫為 "Haiku"，逐字稿記為 "Hiku"，標記為需查證。
*   **Gong Agents**：命令列中多次提及 `Gong Agents`，常見 AI 輔助編程工具（如 Cursor, Copilot 等）中較少見此拼寫，疑似為 "Code Agents"、"Cloud Agents" 或其他名稱的聽寫錯誤，或為該特定產品的專屬命令。
*   **月權**：文中提到「防止不同的 Subagents 月權去避免一些風險」，「月權」語意不通，疑似為「越權」的聽寫錯誤。
*   **扒競評**：文中提到「扒競評的网站」，「競評」疑似為「競品」的聽寫錯誤。
*   **写测试用力**：文中提到「写测试用力」，疑似為「写测试用例」的聽寫錯誤。
*   **跑步数上线**：文中提到「跑数据上线」，疑似為「跑数据上线」的聽寫錯誤（原文筆記記為「跑步数上线」）。
*   **主绘画窗口**：文中提到「主绘画窗口的上下文压力」，「绘画」疑似為「對話」或「代碼」的聽寫錯誤，或指代特定 UI 界面。
*   **视例的文案**：文中提到「复制一下这段视例的文案」，「视例」疑似為「示例」的聽寫錯誤。

## 可延伸追問
1.  如何具體設定 Subagents 的工具權限範圍？有哪些預設的權限模板？
2.  Opus、Sonet 和 Hiku 這三種模型在 Cloud Code 中的具體定價差異與性能對比為何？
3.  當 Subagents 執行失敗時，主窗口如何接收錯誤資訊並進行重試或調優？
4.  自然語言創建 Subagents 時，Cloud Code 生成 Prompt 的準確性如何？是否需要人工校對？
5.  在大型專案中，如何組織和管理大量的 Subagents Library？是否有分組或標籤功能？