# 策展 · X (Twitter) 🔥🔥
> 📖 本站完整內容索引（documentation index）：[llms.txt](/llms.txt)
> 作者：Nate Herk (@nateherk) · 平台：X (Twitter) · 日期：2026-06-10
> 原始來源：https://x.com/nateherk/status/2064326627719311775
## 中文摘要
# 如何打造比 99% 的人都更強的 Claude Subagents
一個聰明的老闆，加上一群便宜的 Agent。
這就是讓 Claude Code 的 Subagents（子 Agent）發揮作用的核心心法。
你的主對話視窗就是老闆。它負責與你溝通，然後悄悄地將工作交辦給一群會回報進度的 Agent 團隊。
大多數人要麼從未使用過 Subagents，要麼就是用錯了方式。以下教你如何運用它們，達到超越絕大多數人的境界。
展開畫面重點
圖片展示了「子代理（Subagent）」的運作概念，標題為「A subagent is a specialist you send off」（子代理是你派遣出去的專家）。
流程說明如下：
1. 「MAIN CHAT (you)」（主對話/使用者）發送「go do a job」（去執行一項工作）的指令給「SUBAGENT」。
2. 「SUBAGENT」負責執行具體任務，包括「reads files」（讀取檔案）、「runs tests」（執行測試）、「digs」（深入挖掘資訊）。
3. 「SUBAGENT」完成工作後產生「summary」（摘要）。
4. 最終只有「only the answer comes back」（只有答案會回傳）回到「MAIN CHAT」。
展開畫面重點
圖片呈現了一個系統架構圖，標題為「Smart boss, cheap workers」。
左側為核心決策單元「THE LEAD」，使用高階模型（Sonnet / Opus），標記為「$$」（高成本）。
右側為三個執行單元，皆使用輕量級模型（Haiku），標記為「$」（低成本），分別負責：
1. scan files（掃描檔案）
2. search code（搜尋程式碼）
3. summarize logs（總結日誌）
該架構意在透過高階模型進行任務規劃與指揮，再由低成本模型處理繁瑣的基礎任務，達到效能與成本的最佳化。
展開畫面重點
本圖透過對比說明了 AI 代理的工作流程差異：
1. 左側「Do it yourself」：顯示一個圓形圖示，標註「memory fills up」。說明文字指出：「Every file you read piles into your chat and stays there all session.」（你讀取的每個檔案都會堆積在對話中，並在整個對話期間持續佔用記憶體）。
2. 右側「Send a subagent」：顯示一個矩形圖示，標註「mess stays here」（混亂留在這裡），並透過箭頭指向另一個較小的矩形「clean」（乾淨）。說明文字指出：「It reads the pile in its own window. You get one clean summary.」（它在獨立的視窗中讀取這些堆積的檔案，你最終只會得到一份乾淨的摘要）。
展開畫面重點
圖片呈現了一個階梯狀的架構圖，將 Claude 模型分為三個等級，並標示了其成本與適用場景：
1. **Haiku**：標示為「$」，適用於 scan（掃描）、search（搜尋）、docs（文件處理）。
2. **Sonnet**：標示為「$$」，適用於 build（建構）、review（審閱）。
3. **Opus**：標示為「$$$」，適用於 deep reasoning（深度推理）、security（安全性）。
這些模型透過虛線連接，呈現由輕量級到重量級的遞進關係。
展開畫面重點
圖片標題為「Each one is a specialist」（每一位都是專家），下方列出了四個專門的 AI 角色及其職責：
1. **security-auditor**：負責找出漏洞 (finds vulnerabilities)。
2. **test-runner**：負責執行並修復測試 (runs and fixes tests)。
3. **doc-writer**：負責保持文件同步 (keeps docs in sync)。
4. **db-expert**：負責執行安全的資料庫查詢 (safe queries only)。
圖片底部總結了核心理念：「One AI doing one thing really well beats one AI doing everything okay. So you split the work across experts.」（一個 AI 把一件事做得非常好，勝過一個 AI 把所有事做得普通。因此，你將工作分配給不同的專家。）
展開畫面重點
這張圖片顯示了一個用於設定 AI 代理的 YAML 格式配置區塊，內容如下：
---
name: code-reviewer
description: Review code after changes. Use proactively.
tools: Read, Grep, Glob, Bash
model: sonnet
---
You are a senior code reviewer.
When invoked:
1. Run git diff to see the changes
2. Review the modified files
Flag: bugs, security holes, missing tests.
這段內容定義了一個名為「code-reviewer」的 AI 代理，其核心任務是擔任「資深程式碼審查員」。配置中指定了該代理可使用的工具（Read, Grep, Glob, Bash）以及所使用的模型（sonnet）。在執行邏輯上，它被要求在被呼叫時執行 `git diff` 來查看變更，審查修改過的檔案，並特別標記出程式錯誤（bugs）、安全漏洞（security holes）以及缺失的測試（missing tests）。
展開畫面重點
這是一份名為 `clickup-searcher.md` 的設定檔，用於定義一個專門處理 ClickUp 資料的 AI 代理。內容如下：
```markdown
---
name: clickup-searcher
description: "Searches and analyzes ClickUp data. Use this agent whenever a skill or task needs to pull tasks, subtasks, statuses, or other data from ClickUp. Keeps ClickUp API responses out of the main conversation context."
model: sonnet
color: green
---
You are a ClickUp data analyst. Your job is to query ClickUp, process the results, and return clean, structured summaries.
## How You Work
- You receive a specific query or set of instructions from the parent conversation
- You use ClickUp MCP tools OR the `clickup_chat.py` script to pull data
- You process and analyze the raw data
- You return a clean, structured summary -- not raw API responses
```
**畫面重點解讀：**
1. **元數據（Metadata）**：定義了代理名稱（clickup-searcher）、描述、使用的模型（sonnet）以及介面顏色（green）。
2. **角色定位**：明確指出該代理的角色為「ClickUp 資料分析師」。
3. **工作流程**：規範了代理的操作邏輯，強調必須將原始 API 回應進行處理與結構化，避免將冗長的原始資料直接輸出給使用者，以保持對話的簡潔與易讀性。
展開畫面重點
圖表分為三個區塊，說明何時該使用 AI 代理（Reach for one）以及何時該避免（Skip it）：
**Reach for one（建議使用）：**
- 它會讀取大量的檔案。
- 它會產生大量的輸出內容。
- 這是一項需要重複執行的工作。
- 獨立的工作，可以並行執行。
- 你需要一位公正的審查者。
**Skip it（建議跳過/不使用）：**
- 這只是一個快速的編輯。
- 步驟之間具有前後依賴關係。
- 代理之間需要進行對話。
- 它需要完整的對話上下文。
- 它需要向你詢問問題。
**Rule of thumb（經驗法則）：**
- 10 個以上的檔案，或是你永遠不會回頭閱讀的輸出內容 = 適合使用子代理（subagent）。
- 擴展訊號：數十個並行工作，或是針對整個程式碼庫的處理 = 適合使用動態工作流（dynamic workflow）。
展開畫面重點
圖片標題為「A read-only agent cannot break things」（唯讀代理人無法破壞事物）。中間方框標示為「code-reviewer」，並註解「an agent that only looks, never touches」（一個只會查看、絕不更動的代理人）。下方列出了五個權限狀態：
- 已啟用（綠色框）：Read（讀取）、Grep（搜尋）、Glob（檔案匹配）。
- 已停用（紅色框）：Write（寫入）、Edit（編輯）。
這張圖說明了透過限制代理人的權限，可以有效防止其對程式碼庫造成意外的損壞。