Claude Code Skills 與 Subagent 架構：打造可復用的 AI 工作流模組
Claude Code 的 Skills 與 Subagent 系統代表了 AI 代理開發從單次提示互動升級為持久化、可復用工作流模組的關鍵架構升級。透過 Skills，開發者可以將領域知識封裝為可自動喚起的指令集；透過 Subagents，則能實現真正的多代理協作，讓主代理在需要時才喚起專家工作者，避免上下文窗口被過量內容污染。本文將提供端到端的設計模式與真實場景示範，幫助你建構生產級的 AI 工作流。
Skills：可復用的指令集
Skills 是 Claude Code 中最基礎的模組化機制。每個 Skill 本質上是一組指令集，當 AI 代理判斷任務相關時會自動存取。開發者只需在專案根目錄建立 .claude/skills/ 資料夾，並在裡面放置 skill.md 文件即可啟用。
Skill 的核心價值在於「情境感知喚起」——代理會根據當前任務內容自動判斷是否需要啟用特定技能。這種機制類似於傳統軟體的 decorator 或 middleware，但更靈活且具備自然語言理解能力。
建立第一個 Skill
在專案根目執行以下指令即可建立結構：
mkdir -p .claude/skills
touch .claude/skills/skill.md編寫 skill.md 內容，範例如下：
# Code Review Skill
## 觸發條件
當用戶要求審查代碼、進行 code review、或提到「檢查錯誤」時觸發。
## 執行步驟
1. 理解代碼的業務邏輯
2. 檢查潛在的 bug 和邏輯錯誤
3. 評估代碼風格一致性
4. 識別安全漏洞（如 SQL injection、XSS）
5. 提供具體的改進建議
## 輸出格式
- 問題清單（嚴重性分級：高/中/低）
- 具體程式碼位置與建議修改
- 總體評分與改進優先順序建立完成後，當你在對話中提到「幫我 review 這段程式碼」時，Claude Code 會自動載入這個 Skill 的指令集，無需手動指定。這種自動化機制大幅提升了開發效率。
Subagent：懶加載的專家工作者
Subagents 是 Claude Code 多代理架構的核心組件。與 Skills 不同，Subagents 是完整的工作者實例，具備獨立的思考與執行能力。關鍵設計在於「懶加載」——主代理知道有哪些專家可用，但只在任務真正需要時才啟動對應的子代理。
這種設計有效保護了主上下文窗口不被過量內容污染。在傳統單代理架構中，所有資訊都堆積在同一個上下文窗口，很快就會達到 token 上限。Subagent 架構讓每個工作者在隔離的上下文中運作，只在需要時才交換結果。
Subagent 註冊與使用
在 CLAUDE.md 中註冊 Subagent 的語法如下：
# Project Context
## Available Subagents
### code-reviewer
擅長代碼審查與品質優化。當需要深入分析代碼問題時使用。
### security-auditor
專注於安全漏洞掃描與合規性檢查。處理認證、授權、加密相關任務時喚起。
### documentation-writer
技術文檔寫作專家。生成 API 文檔、README、架構說明時使用。
## 使用方式
要喚起某個 Subagent，只需在任務描述中提及其名稱或功能需求，
主代理會自動判斷並分配任務。Subagent 的設計理念是「專業分工」——主代理類似團隊負責人，負責規劃與協調；子代理則是各領域專家，專注執行特定任務。這種分工模式與人類組織的團隊運作高度相似。
Agent Teams：多代理協作實驗
Claude Code 還提供實驗性的 Agent Teams 功能，允許協調多個 Claude Code 會話共同工作。這種模式適用於需要並行處理的複雜任務。
在 Agent Teams 中，一個會話充當團隊負責人，負責協調工作、分配任務、綜合結果；團隊成員則在各自的上下文窗口中獨立運作。這種架構特別適合大規模程式碼遷移、系統重構等需要多面向專業知識的任務。
多代理系統的核心挑戰在於上下文隔離與資訊共享的平衡。每個代理操作在隔離的上下文窗口中，但共享對持久化規格和檢索工件的訪問。Claude Code 透過 CLAUDE.md 文件、MCP 整合和多代理協作機制，構建了完整的上下文管理解決方案。
實際應用場景與設計模式
讓我們透過一個真實場景來展示 Skills + Subagent 的組合威力。假設你需要開發一個 API 服務，包含以下環節：設計介面、實現業務邏輯、撰寫文檔、進行安全審查。
使用傳統單代理方式，代理需要在單一對話中處理所有需求，容易遺漏細節且難以維護。使用 Skills + Subagent 架構的話，流程可以這樣設計：
- 主代理：理解整體需求，規劃任務分配
- API Designer Subagent：設計 RESTful 介面與資料模型
- Security Auditor Subagent：檢查認證機制與輸入驗證
- Documentation Writer Subagent：生成 OpenAPI 規格與使用指南
這種架構的優勢在於每個 Subagent 可以深度聚焦自身領域，同時保持對整體目標的對齊。主代理負責協調，避免了上下文污染問題。
結論與實踐建議
Claude Code 的 Skills 與 Subagent 架構為 AI 工作流設計提供了標準化的模組化方案。Skills 適合封裝領域知識與最佳實踐，Subagent 適合處理需要深度專業能力的獨立任務。
實踐上，建議從以下開始：先建立團隊共用的 Skills 庫沈澱常用指令模式；再根據專案需求逐步引入 Subagent 處理複雜流程。記住核心原則——讓每個模組專注单一职责，透過明確的介面協作。這種設計不僅提升當前效率，更為未來的維護與擴展奠定基礎。