Shannon MCP

🚀 Claude代碼子代理集合

這是一個專為Claude Code打造的專業AI子代理綜合集合，旨在憑藉特定領域的專業知識優化開發工作流程。

🚀 快速開始

本倉庫包含46個專業子代理，可擴展Claude Code的功能。每個子代理都是特定領域的專家，會根據上下文自動調用，或在需要時手動調用。所有代理均根據任務複雜度配置了特定的Claude模型，以實現最佳性能和成本效益。

✨ 主要特性

• 領域廣泛：涵蓋開發與架構、語言專家、基礎設施與運維、質量與安全、數據與AI、專業領域、商業與營銷等多個領域。
• 模型適配：根據任務複雜度為46個子代理配置特定的Claude模型，如Claude Haiku 3.5、Claude Sonnet 4、Claude Opus 4。
• 調用靈活：支持自動調用和顯式調用兩種方式。

📦 安裝指南

將這些子代理放置在~/.claude/agents/目錄下即可自動使用。

cd ~/.claude
git clone https://github.com/wshobson/agents.git

💻 使用示例

基礎用法

單代理任務

# 代碼質量與審查
"使用代碼審查員分析此組件的最佳實踐"
"讓安全審計員檢查是否存在OWASP合規問題"

# 開發任務
"讓後端架構師設計用戶認證API"
"使用前端開發人員創建響應式儀表板佈局"

# 基礎設施與運維
"讓DevOps故障排除員分析這些生產日誌"
"使用雲架構師設計可擴展的AWS架構"
"讓網絡工程師調試SSL證書問題"
"使用數據庫管理員設置備份和複製"

# 數據與AI
"讓數據科學家分析此客戶行為數據集"
"使用AI工程師構建用於文檔搜索的RAG系統"
"讓MLOps工程師設置MLflow實驗跟蹤"

# 商業與營銷
"讓商業分析師創建帶有增長指標的投資者演示文稿"
"使用內容營銷人員撰寫SEO優化的博客文章"
"讓銷售自動化員創建冷郵件序列"
"讓客戶支持人員起草常見問題解答文檔"

多代理工作流

這些子代理可以無縫協作，對於更復雜的編排，可使用Claude代碼命令集合，其中提供了52個預構建的斜槓命令，可在複雜工作流中利用這些子代理。

# 功能開發工作流
"實現用戶認證功能"
# 自動使用：後端架構師 → 前端開發人員 → 測試自動化員 → 安全審計員

# 性能優化工作流
"優化結賬流程性能"
# 自動使用：性能工程師 → 數據庫優化員 → 前端開發人員

# 生產事故工作流
"調試生產中的高內存使用問題"
# 自動使用：事故響應員 → DevOps故障排除員 → 錯誤偵探 → 性能工程師

# 網絡連接工作流
"修復間歇性API超時問題"
# 自動使用：網絡工程師 → DevOps故障排除員 → 性能工程師

# 數據庫維護工作流
"為生產數據庫設置災難恢復"
# 自動使用：數據庫管理員 → 數據庫優化員 → 事故響應員

# ML管道工作流
"構建帶有監控的端到端ML管道"
# 自動使用：MLOps工程師 → ML工程師 → 數據工程師 → 性能工程師

# 產品發佈工作流
"通過營銷活動推出新功能"
# 自動使用：商業分析師 → 內容營銷人員 → 銷售自動化員 → 客戶支持人員

高級工作流與斜槓命令

對於更復雜的多子代理編排，可使用配套的命令倉庫：

# 複雜功能開發（8個以上子代理）
/full-stack-feature 構建帶有即時分析的用戶儀表板

# 生產事故響應（5個以上子代理）
/incident-response 數據庫連接池耗盡

# ML基礎設施設置（6個以上子代理）
/ml-pipeline 創建帶有A/B測試的推薦引擎

# 以安全為重點的實施（7個以上子代理）
/security-hardening 實施帶有零信任架構的OAuth2

高級用法

瞭解每個子代理的適用場景，根據不同的任務需求選擇合適的子代理，以達到最佳效果。

📚 詳細文檔

可用子代理

開發與架構

• backend-architect - 設計RESTful API、微服務邊界和數據庫架構
• frontend-developer - 構建React組件、實現響應式佈局並處理客戶端狀態管理
• mobile-developer - 開發帶有原生集成的React Native或Flutter應用
• graphql-architect - 設計GraphQL架構、解析器和聯合
• architect-reviewer - 審查代碼更改的架構一致性和模式

語言專家

• python-pro - 編寫具有高級功能和優化的地道Python代碼
• golang-pro - 編寫具有goroutine、通道和接口的地道Go代碼
• rust-pro - 編寫具有所有權模式、生命週期和特徵實現的地道Rust代碼
• c-pro - 編寫具有適當內存管理和系統調用的高效C代碼
• cpp-pro - 編寫具有現代功能、RAII、智能指針和STL算法的地道C++代碼
• javascript-pro - 掌握具有ES6+、異步模式和Node.js API的現代JavaScript
• php-pro - 編寫具有現代功能和性能優化的地道PHP代碼
• sql-pro - 編寫複雜的SQL查詢、優化執行計劃並設計規範化架構

基礎設施與運維

• devops-troubleshooter - 調試生產問題、分析日誌並修復部署失敗
• deployment-engineer - 配置CI/CD管道、Docker容器和雲部署
• cloud-architect - 設計AWS/Azure/GCP基礎設施並優化雲成本
• database-optimizer - 優化SQL查詢、設計高效索引並處理數據庫遷移
• database-admin - 管理數據庫操作、備份、複製和監控
• terraform-specialist - 編寫高級Terraform模塊、管理狀態文件並實施IaC最佳實踐
• incident-responder - 緊急且精確地處理生產事故
• network-engineer - 調試網絡連接、配置負載均衡器並分析流量模式
• dx-optimizer - 改善工具、設置和工作流程的開發體驗專家

質量與安全

• code-reviewer - 進行代碼質量、安全性和可維護性的專業審查
• security-auditor - 審查代碼中的漏洞並確保符合OWASP標準
• test-automator - 創建包含單元、集成和端到端測試的綜合測試套件
• performance-engineer - 分析應用程序性能、優化瓶頸並實施緩存策略
• debugger - 調試錯誤、測試失敗和意外行為
• error-detective - 在日誌和代碼庫中搜索錯誤模式、堆棧跟蹤和異常
• search-specialist - 使用高級搜索技術和綜合方法進行專業網絡研究

數據與AI

• data-scientist - 進行SQL查詢、BigQuery操作和數據分析的專家
• data-engineer - 構建ETL管道、數據倉庫和流式架構
• ai-engineer - 構建大語言模型（LLM）應用程序、RAG系統和提示管道
• ml-engineer - 實施機器學習管道、模型服務和特徵工程
• mlops-engineer - 構建機器學習管道、實驗跟蹤和模型註冊表
• prompt-engineer - 優化大語言模型和AI系統的提示

專業領域

• api-documenter - 創建OpenAPI/Swagger規範並編寫開發人員文檔
• payment-integration - 集成Stripe、PayPal和支付處理器
• quant-analyst - 構建金融模型、回測交易策略並分析市場數據
• risk-manager - 監控投資組合風險、R倍數和頭寸限制
• legacy-modernizer - 重構遺留代碼庫並實施漸進式現代化
• context-manager - 管理多個代理和長時間運行任務的上下文

商業與營銷

• business-analyst - 分析指標、創建報告並跟蹤關鍵績效指標（KPI）
• content-marketer - 撰寫博客文章、社交媒體內容和電子郵件通訊
• sales-automator - 起草冷郵件、跟進郵件和提案模板
• customer-support - 處理支持工單、常見問題解答響應和客戶電子郵件
• legal-advisor - 起草隱私政策、服務條款、免責聲明和法律通知

模型分配

所有46個子代理均根據任務複雜度配置了特定的Claude模型：

🚀 Claude Haiku 3.5（快速且經濟高效） - 8個代理

模型：claude-3-5-haiku-20241022

• data-scientist - SQL查詢和數據分析
• api-documenter - OpenAPI/Swagger文檔
• business-analyst - 指標和KPI跟蹤
• content-marketer - 博客文章和社交媒體
• customer-support - 支持工單和常見問題解答
• sales-automator - 冷郵件和提案
• search-specialist - 網絡研究和信息收集
• legal-advisor - 隱私政策和合規文檔

⚡ Claude Sonnet 4（性能均衡） - 26個代理

模型：claude-sonnet-4-20250514

開發與語言：

• python-pro - 具有高級功能的Python開發
• javascript-pro - 現代JavaScript和Node.js
• golang-pro - Go併發和地道模式
• rust-pro - Rust內存安全和系統編程
• c-pro - C編程和嵌入式系統
• cpp-pro - 具有STL和模板的現代C++
• frontend-developer - React組件和UI
• backend-architect - API設計和微服務
• mobile-developer - React Native/Flutter應用
• sql-pro - 複雜SQL優化
• graphql-architect - GraphQL架構和解析器

基礎設施與運維：

• devops-troubleshooter - 生產調試
• deployment-engineer - CI/CD管道
• database-optimizer - 查詢優化
• database-admin - 數據庫操作
• terraform-specialist - 基礎設施即代碼
• network-engineer - 網絡配置
• dx-optimizer - 開發體驗
• data-engineer - ETL管道

質量與支持：

• test-automator - 測試套件創建
• code-reviewer - 代碼質量分析
• debugger - 錯誤調查
• error-detective - 日誌分析
• ml-engineer - ML模型部署
• legacy-modernizer - 框架遷移
• payment-integration - 支付處理

🧠 Claude Opus 4（能力最強） - 11個代理

模型：claude-opus-4-20250514

• ai-engineer - 大語言模型應用程序和RAG系統
• security-auditor - 漏洞分析
• performance-engineer - 應用程序優化
• incident-responder - 生產事故處理
• mlops-engineer - 機器學習基礎設施
• architect-reviewer - 架構一致性
• cloud-architect - 雲基礎設施設計
• prompt-engineer - 大語言模型提示優化
• context-manager - 多代理協調
• quant-analyst - 金融建模
• risk-manager - 投資組合風險管理

子代理格式

每個子代理遵循以下結構：

---
name: subagent-name
description: 應調用此子代理的場景
model: claude-3-5-haiku-20241022  # 可選 - 指定要使用的模型
tools: tool1, tool2  # 可選 - 默認使用所有工具
---

定義子代理角色和能力的系統提示

模型配置

從Claude Code v1.0.64開始，子代理可以指定應使用的Claude模型。這允許根據複雜度進行經濟高效的任務委派：

• 低複雜度（Haiku 3.5）：簡單任務，如基本數據分析、文檔生成和標準響應
• 中等複雜度（Sonnet 4）：開發任務、代碼審查、測試和標準工程工作
• 高複雜度（Opus 4）：關鍵任務，如安全審計、架構審查、事故響應和AI/ML工程

可用模型：

• claude-3-5-haiku-20241022 - 適用於簡單任務的快速且經濟高效的模型
• claude-sonnet-4-20250514 - 適用於大多數開發工作的性能均衡模型
• claude-opus-4-20250514 - 適用於複雜分析和關鍵任務的能力最強的模型

如果未指定模型，子代理將使用系統的默認模型。

代理編排模式

Claude Code使用以下常見模式自動協調代理：

順序工作流

用戶請求 → 代理A → 代理B → 代理C → 結果

示例："構建新的API功能"
後端架構師 → 前端開發人員 → 測試自動化員 → 安全審計員

並行執行

用戶請求 → 代理A + 代理B（同時） → 合併結果

示例："優化應用程序性能"
性能工程師 + 數據庫優化員 → 綜合建議

條件分支

用戶請求 → 分析 → 路由到合適的專家

示例："修復此錯誤"
調試器（分析） → 路由到：後端架構師 或 前端開發人員 或 DevOps故障排除員

審查與驗證

主要代理 → 審查代理 → 最終結果

示例："實施支付處理"
支付集成 → 安全審計員 → 經過驗證的實施

何時使用哪個代理

🏗️ 規劃與架構

• backend-architect：API設計、數據庫架構、系統架構
• frontend-developer：UI/UX規劃、組件架構
• cloud-architect：基礎設施設計、可擴展性規劃

🔧 實施與開發

• python-pro：特定於Python的開發任務
• golang-pro：特定於Go的開發任務
• rust-pro：特定於Rust的開發、內存安全、系統編程
• c-pro：C編程、嵌入式系統、對性能要求高的代碼
• javascript-pro：現代JavaScript、異步模式、Node.js/瀏覽器代碼
• sql-pro：數據庫查詢、架構設計、查詢優化
• mobile-developer：React Native/Flutter開發

🛠️ 運維與維護

• devops-troubleshooter：生產問題、部署問題
• incident-responder：需要立即響應的嚴重故障
• database-optimizer：查詢性能、索引策略
• database-admin：備份策略、複製、用戶管理、災難恢復
• terraform-specialist：基礎設施即代碼、Terraform模塊、狀態管理
• network-engineer：網絡連接、負載均衡器、SSL/TLS、DNS調試

📊 分析與優化

• performance-engineer：應用程序瓶頸、優化
• security-auditor：漏洞掃描、合規性檢查
• data-scientist：數據分析、洞察、報告
• mlops-engineer：機器學習基礎設施、實驗跟蹤、模型註冊表、管道自動化

🧪 質量保證

• code-reviewer：代碼質量、可維護性審查
• test-automator：測試策略、測試套件創建
• debugger：錯誤調查、錯誤解決
• error-detective：日誌分析、錯誤模式識別、根本原因分析
• search-specialist：深度網絡研究、競爭分析、事實核查

💼 商業與戰略

• business-analyst：關鍵績效指標、收入模型、增長預測、投資者指標
• risk-manager：投資組合風險、對沖策略、R倍數、頭寸規模
• content-marketer：SEO內容、博客文章、社交媒體、電子郵件營銷活動
• sales-automator：冷郵件、跟進、提案、潛在客戶培育
• customer-support：支持工單、常見問題解答、幫助文檔、故障排除
• legal-advisor - 起草隱私政策、服務條款、免責聲明和法律通知

最佳實踐

🎯 任務委派

1. 讓Claude Code自動委派 - 主代理會分析上下文並選擇最佳代理
2. 明確需求 - 包括約束條件、技術棧和質量要求
3. 信任代理的專業知識 - 每個代理都針對其領域進行了優化

🔄 多代理工作流

4. 從高級請求開始 - 讓代理協調複雜的多步驟任務
5. 在代理之間提供上下文 - 確保代理擁有必要的背景信息
6. 審查集成點 - 檢查不同代理的輸出如何協同工作

🎛️ 顯式控制

7. 為特定需求使用顯式調用 - 當你需要特定專家的觀點時
8. 策略性地組合多個代理 - 不同的專家可以相互驗證工作
9. 請求特定的審查模式 - "讓安全審計員審查後端架構師的API設計"

📈 優化

10. 監控代理的有效性 - 瞭解哪些代理最適合你的用例
11. 對複雜任務進行迭代 - 使用代理的反饋來完善需求
12. 利用代理的優勢 - 根據任務複雜度匹配代理的能力

貢獻

要添加新的子代理：

1. 創建一個遵循上述格式的新.md文件
2. 使用小寫、連字符分隔的名稱
3. 為子代理的使用場景編寫清晰的描述
4. 在系統提示中包含具體說明

故障排除

常見問題

代理未自動調用：

• 確保你的請求明確指出了領域（例如，"性能問題" → 性能工程師）
• 明確任務類型（例如，"審查代碼" → 代碼審查員）

意外選擇代理：

• 提供更多關於你的技術棧和需求的上下文
• 如果你需要特定的代理，請使用顯式調用

多個代理提供衝突的建議：

• 這是正常的 - 不同的專家可能有不同的優先級
• 請求澄清："協調安全審計員和性能工程師的建議"

代理似乎缺乏上下文：

• 在請求中提供背景信息
• 參考之前的對話或已建立的模式

獲取幫助

如果代理未按預期工作：

1. 檢查各個代理文件中的描述
2. 在請求中使用更具體的語言
3. 使用顯式調用測試特定的代理
4. 提供更多關於你的項目和目標的上下文

瞭解更多

• Claude Code文檔
• 子代理文檔
• Claude Code GitHub