Claude Code 子代理集合
一个专为 Claude Code 设计的全面专业 AI 子代理集合,旨在以领域专长提升开发工作流。
概览
本仓库包含 76 个专业子代理,可扩展 Claude Code 的能力。每个子代理都是某一特定领域的专家,会根据上下文自动调用或在需要时显式调用。所有代理均根据任务复杂度配置了特定的 Claude 模型,以实现最佳性能和成本效益。
可用子代理
开发与架构
- backend-architect - 设计 RESTful API、微服务边界和数据库模式
- frontend-developer - 构建 React 组件,实现响应式布局,处理客户端状态管理
- ui-ux-designer - 创建界面设计、线框图和设计系统
- ui-visual-validator - 通过严密的截图分析验证 UI 修改是否达到了预期目标
- mobile-developer - 开发具有原生集成的 React Native 或 Flutter 应用
- graphql-architect - 设计 GraphQL 架构、解析器和联邦
- architect-reviewer - 审查代码变更以确保架构一致性和设计模式
语言专家
- python-pro - 编写惯用 Python 代码,运用高级特性和优化
- ruby-pro - 编写惯用 Ruby 代码,使用元编程、Rails 模式、gem 开发和测试框架
- golang-pro - 编写惯用 Go 代码,利用 goroutine、channel 和接口
- rust-pro - 编写惯用 Rust,运用所有权模式、生命周期和 trait 实现
- c-pro - 编写高效 C 代码,正确管理内存并进行系统调用
- cpp-pro - 编写惯用 C++ 代码,运用现代特性、RAII、智能指针和 STL 算法
- javascript-pro - 精通现代 JavaScript,掌握 ES6+、异步模式和 Node.js API
- typescript-pro - 精通 TypeScript,掌握高级类型、泛型和严格类型安全
- php-pro - 编写惯用 PHP 代码,运用现代特性和性能优化
- java-pro - 精通现代 Java,掌握流、并发和 JVM 优化
- elixir-pro - 编写惯用 Elixir 代码,运用 OTP 模式、函数式编程和 Phoenix 框架
- csharp-pro - 编写现代 C# 代码,运用高级特性和 .NET 优化
- scala-pro - 精通企业级 Scala 开发,掌握函数式编程、分布式系统和大数据处理
- flutter-expert - 精通 Flutter 开发,掌握 Dart、小部件和平台集成
- unity-developer - 构建 Unity 游戏,实现脚本优化和性能调优
- minecraft-bukkit-pro - 精通 Minecraft 服务器插件开发,运用 Bukkit、Spigot 和 Paper API
- ios-developer - 使用 Swift/SwiftUI 开发原生 iOS 应用
- sql-pro - 编写复杂 SQL 查询,优化执行计划,设计规范化数据模式
基础设施与运维
- devops-troubleshooter - 调试生产问题,分析日志,修复部署故障
- deployment-engineer - 配置 CI/CD 流水线、Docker 容器和云部署
- cloud-architect - 设计 AWS/Azure/GCP 基础设施并优化云成本
- hybrid-cloud-architect - 跨 AWS/Azure/GCP 及 OpenStack 本地环境设计混合云基础设施
- kubernetes-architect - 以 Kubernetes 为核心设计云原生基础设施,贯彻 GitOps 原则,适用于 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 - 使用高级搜索技术和综合能力的网络研究专家
数据与人工智能
- data-scientist - SQL 查询、大数据操作和数据洞察分析专家
- data-engineer - 构建 ETL 流程、数据仓库和流式架构
- ai-engineer - 构建 LLM 应用、RAG 系统及提示管道
- ml-engineer - 实现机器学习流程、模型服务和特征工程
- mlops-engineer - 构建机器学习流程、实验追踪和模型注册表
- prompt-engineer - 优化 LLM 和 AI 系统的提示词
专业领域
- api-documenter - 创建 OpenAPI/Swagger 规范并编写开发者文档
- payment-integration - 集成 Stripe、PayPal 及支付处理器
- quant-analyst - 构建金融模型、回测交易策略并分析市场数据
- risk-manager - 监控投资组合风险、R 倍数及持仓限额
- legacy-modernizer - 重构遗留代码库并实施渐进式现代化
- context-manager - 管理多个代理和长周期任务的上下文
文档
- docs-architect - 根据现有代码库创建全面技术文档
- mermaid-expert - 绘制流程图、序列图、ERD 和架构的 Mermaid 图表
- reference-builder - 创建详尽技术参考和 API 文档
- tutorial-engineer - 从代码创建分步骤教程和教育内容
商业与市场
- business-analyst - 分析指标、创建报告并跟踪关键绩效指标
- content-marketer - 撰写博客、社交媒体内容及邮件简报
- hp-pro - 负责招聘、入职/离职、休假及假期、绩效、合规政策和员工关系。
- sales-automator - 起草冷邮件、跟进和提案模板
- customer-support - 处理支持工单、常见问题和客户邮件
- legal-advisor - 起草隐私政策、服务条款、免责声明和法律声明
SEO与内容优化
- seo-content-auditor - 分析所提供内容的质量、E-E-A-T信号和SEO最佳实践
- seo-meta-optimizer - 创建优化的元标题、描述和URL建议
- seo-keyword-strategist - 分析关键词使用情况,计算密度,建议语义变体
- seo-structure-architect - 优化内容结构、标题层级和结构化标记
- seo-snippet-hunter - 格式化内容以适应精选摘要和SERP特性
- seo-content-refresher - 识别过时元素并建议内容更新
- seo-cannibalization-detector - 分析多个页面的关键词重叠和冲突
- seo-authority-builder - 分析内容的E-E-A-T信号和信任指标
- seo-content-writer - 根据关键词和简要信息编写SEO优化内容
- seo-content-planner - 创建内容大纲、主题集群和日历
模型分配
所有76个子代理根据任务复杂度配置了特定的Claude模型:
🚀 Haiku(快速且高性价比)- 15个代理
模型:haiku
data-scientist- SQL查询和数据分析api-documenter- OpenAPI/Swagger文档编写reference-builder- 全面的技术参考和API文档business-analyst- 指标和KPI跟踪content-marketer- 博客文章和社交媒体内容customer-support- 支持工单和常见问题sales-automator- 冷邮件和提案search-specialist- 网络研究和信息收集legal-advisor- 隐私政策和合规性文件seo-meta-optimizer- 元标题和描述优化seo-keyword-strategist- 关键词密度与语义分析seo-structure-architect- 内容结构与结构化标记seo-snippet-hunter- 精选摘要格式化seo-content-refresher- 内容更新与新鲜度提升seo-cannibalization-detector- 关键词重叠检测seo-content-planner- 内容日历和大纲
⚡ Sonnet(均衡性能)- 45个代理
模型:sonnet开发与编程语言:
python-pro- 具备高级特性的Python开发ruby-pro- Ruby开发,支持元编程、Rails模式和gem开发javascript-pro- 现代JavaScript和Node.js开发typescript-pro- 高级TypeScript类型系统golang-pro- Go并发与惯用模式rust-pro- Rust内存安全与系统编程c-pro- C语言编程与嵌入式系统cpp-pro- 现代C++,包括STL与模板php-pro- 现代PHP高级特性开发java-pro- 现代Java,流与并发编程elixir-pro- Elixir OTP模式与Phoenix框架csharp-pro- 现代C#,.NET框架与设计模式scala-pro- 企业级Scala,集成Apache Pekko、Akka、Spark和ZIO/Cats Effectflutter-expert- Flutter开发,状态管理与动画unity-developer- Unity游戏开发与优化minecraft-bukkit-pro- Minecraft插件开发,支持Bukkit/Spigot/Paperios-developer- 原生iOS开发,Swift/SwiftUIfrontend-developer- React组件与UI开发ui-ux-designer- 界面设计与线框图ui-visual-validator- 通过截图分析严格验证UIbackend-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- 机器学习模型部署legacy-modernizer- 框架迁移payment-integration- 支付处理mermaid-expert- Mermaid 图表与可视化文档flutter-expert- Flutter 开发seo-content-auditor- 内容质量与 E-E-A-T 分析seo-authority-builder- 权威信号优化seo-content-writer- SEO 优化内容创作
🧠 Opus(最高能力)- 15 个智能体
模型:opus
ai-engineer- 大型语言模型应用与 RAG 系统security-auditor- 漏洞分析performance-engineer- 应用优化incident-responder- 生产事故处理mlops-engineer- 机器学习基础设施architect-reviewer- 架构一致性cloud-architect- 云基础设施设计prompt-engineer- LLM 提示优化context-manager- 多智能体协调quant-analyst- 金融建模risk-manager- 资产组合风险管理docs-architect- 从代码库生成全面技术文档tutorial-engineer- 分步教程和教育内容
安装
当子智能体被放置在 ~/.claude/agents/ 目录时会自动可用。
cd ~/.claude
git clone https://github.com/wshobson/agents.git使用方法
自动调用
Claude Code 会根据任务上下文和子代理的描述自动委派给适当的子代理。显式调用
在请求中提及子代理的名称:"Use the code-reviewer to check my recent changes"
"Have the security-auditor scan for vulnerabilities"
"Get the performance-engineer to optimize this bottleneck"使用示例
单智能体任务
# Code quality and review
"Use code-reviewer to analyze this component for best practices"
"Have code-reviewer scrutinize these configuration changes"
"Have security-auditor check for OWASP compliance issues"Development tasks
"Get backend-architect to design a user authentication API"
"Use frontend-developer to create a responsive dashboard layout"Infrastructure and operations
"Have devops-troubleshooter analyze these production logs"
"Use cloud-architect to design a scalable AWS architecture"
"Get network-engineer to debug SSL certificate issues"
"Use database-admin to set up backup and replication"Data and AI
"Get data-scientist to analyze this customer behavior dataset"
"Use ai-engineer to build a RAG system for document search"
"Have mlops-engineer set up MLflow experiment tracking"Business and marketing
"Have business-analyst create investor deck with growth metrics"
"Use content-marketer to write SEO-optimized blog post"
"Get sales-automator to create cold email sequence"
"Have customer-support draft FAQ documentation"多代理工作流
这些子代理无缝协作,对于更复杂的编排,您可以使用 Claude Code Commands 集合,该集合提供了52个预构建的斜杠命令,利用这些子代理实现复杂的工作流。
# Feature development workflow
"Implement user authentication feature"
Automatically uses: backend-architect → frontend-developer → test-automator → security-auditor
Performance optimization workflow
"Optimize the checkout process performance"
Automatically uses: performance-engineer → database-optimizer → frontend-developer
Production incident workflow
"Debug high memory usage in production"
Automatically uses: incident-responder → devops-troubleshooter → error-detective → performance-engineer
Network connectivity workflow
"Fix intermittent API timeouts"
Automatically uses: network-engineer → devops-troubleshooter → performance-engineer
Database maintenance workflow
"Set up disaster recovery for production database"
Automatically uses: database-admin → database-optimizer → incident-responder
ML pipeline workflow
"Build end-to-end ML pipeline with monitoring"
Automatically uses: mlops-engineer → ml-engineer → data-engineer → performance-engineer
Product launch workflow
"Launch new feature with marketing campaign"
Automatically uses: business-analyst → content-marketer → sales-automator → customer-support
使用斜杠命令的高级工作流
对于更复杂的多子代理编排,请使用配套的Commands 仓库:
# Complex feature development (8+ subagents)
/full-stack-feature Build user dashboard with real-time analyticsProduction incident response (5+ subagents)
/incident-response Database connection pool exhaustedML infrastructure setup (6+ subagents)
/ml-pipeline Create recommendation engine with A/B testingSecurity-focused implementation (7+ subagents)
/security-hardening Implement OAuth2 with zero-trust architecture子代理格式
每个子代理遵循以下结构:
---
name: subagent-name
description: When this subagent should be invoked
model: haiku # Optional - specify which model to use (haiku/sonnet/opus)
tools: tool1, tool2 # Optional - defaults to all tools
System prompt defining the subagent's role and capabilities
模型配置
自 Claude Code v1.0.64 起,子代理可以指定应使用的 Claude 模型。这样可以根据复杂度实现成本效益的任务分配:
- 低复杂度(Haiku):简单任务,如基础数据分析、文档生成和标准响应
- 中等复杂度(Sonnet):开发任务、代码审查、测试和标准工程工作
- 高复杂度(Opus):关键任务,如安全审计、架构评审、事件响应和 AI/ML 工程
haiku- 适合简单任务的快速且经济高效模型sonnet- 适用于大多数开发工作的平衡性能模型opus- 适合复杂分析和关键任务的最强模型
代理编排模式
Claude Code 使用以下常见模式自动协调代理:
顺序工作流
User Request → Agent A → Agent B → Agent C → ResultExample: "Build a new API feature"
backend-architect → frontend-developer → test-automator → security-auditor
Parallel Execution
User Request → Agent A + Agent B (simultaneously) → Merge ResultsExample: "Optimize application performance"
performance-engineer + database-optimizer → Combined recommendations
条件分支
User Request → Analysis → Route to appropriate specialistExample: "Fix this bug"
debugger (analyzes) → Routes to: backend-architect OR frontend-developer OR devops-troubleshooter
审核与验证
Primary Agent → Review Agent → Final ResultExample: "Implement payment processing"
payment-integration → security-auditor → Validated implementation
何时使用哪个智能代理
🏗️ 规划与架构
- backend-architect:API设计、数据库架构、系统架构
- frontend-developer:UI/UX规划、组件架构
- ui-ux-designer:界面设计、线框图、设计系统、用户调研
- cloud-architect:基础设施设计、可扩展性规划
🔧 实现与开发
- python-pro:Python专属开发任务
- ruby-pro:Ruby元编程、Rails应用、Gem开发、RSpec/Minitest测试
- golang-pro:Go语言专属开发任务
- rust-pro:Rust开发、内存安全、系统编程
- c-pro:C语言编程、嵌入式系统、性能关键代码
- javascript-pro:现代JavaScript、异步模式、Node.js/浏览器代码
- typescript-pro:高级TypeScript、泛型、类型推断、企业模式
- java-pro:现代Java开发、流处理、并发、Spring Boot
- elixir-pro:Elixir开发、OTP模式、Phoenix框架、函数式编程
- csharp-pro:现代C#开发、.NET框架、企业模式
- scala-pro:企业级Scala与函数式编程、Apache Pekko/Akka actor、Apache Spark、ZIO/Cats Effect、响应式架构
- flutter-expert:Flutter开发、Dart、状态管理、动画、跨平台部署
- unity-developer:Unity游戏开发、C#脚本编写、性能优化
- minecraft-bukkit-pro:Minecraft插件开发、事件系统、服务器端功能
- ios-developer:使用Swift/SwiftUI进行原生iOS开发
- 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:深度网络研究、竞争分析、事实核查
📚 文档编写
- api-documenter:OpenAPI/Swagger 规范、API 文档
- docs-architect:全面的技术文档、架构指南、系统手册
- reference-builder:详尽的 API 参考、配置指南、参数文档
- tutorial-engineer:分步教程、学习路径、教育内容
💼 商业与战略
- business-analyst:关键绩效指标、收入模型、增长预测、投资者指标
- risk-manager:投资组合风险、对冲策略、R 倍数、头寸规模
- content-marketer:SEO 内容、博客文章、社交媒体、邮件营销
- sales-automator:冷邮件、跟进、提案、潜在客户培育
- customer-support:支持工单、常见问题、帮助文档、故障排查
- legal-advisor - 起草隐私政策、服务条款、免责声明及法律通知
最佳实践
🎯 任务分配
- 让 Claude Code 自动分配任务——主代理分析上下文并选择最优代理
- 明确需求——包括约束、技术栈和质量要求
- 信任代理专业性——每个代理都针对其领域进行优化
🔄 多代理工作流程
- 从高层请求开始——让代理协调复杂的多步骤任务
- 在代理间提供上下文——确保代理拥有必要的背景信息
- 检查集成点——检查不同代理输出如何协同工作
🎛️ 明确控制
- 为特定需求明确调用——当你想要某位专家的观点时
- 战略性组合多个代理——不同专家可以相互验证成果
- 请求特定审核模式——“让安全审计员审核后端架构师的 API 设计”
📈 优化
- 监控代理效果 - 了解哪些代理最适合你的用例
- 迭代复杂任务 - 利用代理反馈完善需求
- 发挥代理优势 - 将任务复杂度与代理能力相匹配
贡献指南
要添加新的子代理:
- 按上述格式创建新的
.md文件 - 使用小写字母和连字符命名
- 清晰描述该子代理应在何时使用
- 在系统提示中包含具体指令
故障排查
常见问题
代理未被自动调用:
- 确保你的请求明确指出领域(如 “性能问题” → performance-engineer)
- 明确任务类型(如 “代码审核” → code-reviewer)
- 提供更多关于你的技术栈和需求的上下文
- 如需特定代理,请使用明确调用
- 这是正常现象——不同专家可能有不同的优先级
- 可请求澄清:“整合 security-auditor 和 performance-engineer 的建议”
- 在你的请求中提供背景信息
- 引用之前的对话或已建立的模式
获取帮助
如果代理未按预期工作:
- 检查各自文件中的代理描述
- 在请求中尝试更具体的表达
- 使用明确调用测试特定代理
- 提供更多关于你的项目和目标的上下文
许可协议
本项目采用 MIT 许可协议 - 详情请参阅 LICENSE 文件。