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