Files
2026-07-13 11:06:59 +00:00

476 lines
32 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<!-- WEHUB_ZH_README -->
> [!NOTE]
> 本文档由 WeHub 基于上游 README 翻译整理,属于社区翻译,非官方中文文档。
> [English](./README.en.md) · [原始项目](https://github.com/VoltAgent/awesome-claude-code-subagents) · [上游 README](https://github.com/VoltAgent/awesome-claude-code-subagents/blob/HEAD/README.md)
> 原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。
<a href="https://github.com/VoltAgent/voltagent">
<img width="1500" height="500" alt="Group 32" src="https://github.com/user-attachments/assets/55b97c47-8506-4be0-b18f-f5384d063cbb" />
</a>
<br />
<br/>
<div align="center">
<strong>精选 154+ 个 Claude Code 子代理(subagent),涵盖 10 大类别。</strong>
<br />
<br />
</div>
<div align="center">
[![Awesome](https://awesome.re/badge.svg)](https://awesome.re)
![Subagent Count](https://img.shields.io/badge/subagents-154-blue?style=classic)
[![Last Update](https://img.shields.io/github/last-commit/VoltAgent/awesome-claude-code-subagents?label=Last%20update&style=classic)](https://github.com/VoltAgent/awesome-claude-code-subagents)
[![Discord](https://img.shields.io/discord/1361559153780195478.svg?label=&logo=discord&logoColor=ffffff&color=7389D8&labelColor=6A7EC2)](https://s.voltagent.dev/discord)
</div>
# Awesome Claude Code Subagents
本仓库是 Claude Code 子代理(subagent)的权威合集,这些专用 AI 助手面向特定开发任务而设计。
> **关于贡献的说明:** 我们不接受以推广产品、公司或个人项目为主要目的的 PR。子代理必须对 Claude Code 用户具有真实价值,且内容保持厂商中立。若希望在本社区展示你的项目,可改为[赞助本仓库](#sponsors)——这是在此展示你工作的官方途径。
## Installation
### As Claude Code Plugin (Recommended)
```bash
claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install <plugin-name>
```
Examples:
```bash
claude plugin install voltagent-lang # Language specialists
claude plugin install voltagent-infra # Infrastructure & DevOps
```
See [Categories](#-categories) below for all available plugins.
> **Note**: The `voltagent-meta` orchestration agents work best when other categories installed.
### Option 1: Manual Installation
1. Clone this repository
2. Copy desired agent files to:
- `~/.claude/agents/` for global access
- `.claude/agents/` for project-specific use
3. Customize based on your project requirements
### Option 2: Interactive Installer
```bash
git clone https://github.com/VoltAgent/awesome-claude-code-subagents.git
cd awesome-claude-code-subagents
./install-agents.sh
```
This interactive script lets you browse categories, select agents, and install/uninstall them with a single command.
### Option 3: Standalone Installer (no clone required)
```bash
curl -sO https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/install-agents.sh
chmod +x install-agents.sh
./install-agents.sh
```
Downloads agents directly from GitHub without cloning the repository. Requires `curl`.
### Option 4: Agent Installer (use Claude Code to install agents)
```bash
curl -s https://raw.githubusercontent.com/VoltAgent/awesome-claude-code-subagents/main/categories/09-meta-orchestration/agent-installer.md -o ~/.claude/agents/agent-installer.md
```
Then in Claude Code: "Use the agent-installer to show me available categories" or "Find PHP agents and install php-pro globally".
## Sponsors
| | |
| :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------: | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| <a href="https://lite.ego.app/?utm_source=awesome-claude-code-subagents&utm_medium=sponsor&utm_campaign=github-sponsor"><picture><source media="(prefers-color-scheme: dark)" srcset="https://cdn.voltagent.dev/awesome-repo/ego-lite/logo_wordmark_lite_white.svg"><img alt="Ego Lite" src="https://cdn.voltagent.dev/awesome-repo/ego-lite/logo_wordmark_lite_dark.svg" width="425"></picture></a> | [Ego Lite](https://lite.ego.app/?utm_source=awesome-claude-code-subagents&utm_medium=sponsor&utm_campaign=github-sponsor) is the fastest browser for your AI agents to run browser automation tasks, 3.45x faster than agent-browser (Vercel), always free, no setup, and lets your agents run 100+ browser tasks at the same time in their Spaces. |
<br/>
<div align="center">
<table>
<tr>
<td align="center" width="100%">
<h4>👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more.</h4>
<a href="https://sponsors.voltagent.dev/#awesome-claude-code-subagents"><img src="https://img.shields.io/badge/📩_Become_a_Sponsor-Contact_Us-blue?style=for-the-badge&logoColor=white" alt="Become a Sponsor" /></a>
</td>
</tr>
</table>
</div>
## 📚 Categories
### [01. Core Development](categories/01-core-development/)
**Plugin:** `voltagent-core-dev`
Essential development subagents for everyday coding tasks.
- [**api-designer**](categories/01-core-development/api-designer.md) - REST and GraphQL API architect
- [**backend-developer**](categories/01-core-development/backend-developer.md) - Server-side expert for scalable APIs
- [**design-bridge**](categories/01-core-development/design-bridge.md) - Design-to-agent translator
- [**electron-pro**](categories/01-core-development/electron-pro.md) - Desktop application expert
- [**frontend-developer**](categories/01-core-development/frontend-developer.md) - UI/UX specialist for React, Vue, and Angular
- [**fullstack-developer**](categories/01-core-development/fullstack-developer.md) - End-to-end feature development
- [**graphql-architect**](categories/01-core-development/graphql-architect.md) - GraphQL schema and federation expert
- [**microservices-architect**](categories/01-core-development/microservices-architect.md) - Distributed systems designer
- [**mobile-developer**](categories/01-core-development/mobile-developer.md) - Cross-platform mobile specialist
- [**ui-designer**](categories/01-core-development/ui-designer.md) - Visual design and interaction specialist
- [**websocket-engineer**](categories/01-core-development/websocket-engineer.md) - Real-time communication specialist
### [02. Language Specialists](categories/02-language-specialists/)
**Plugin:** `voltagent-lang`
Language-specific experts with deep framework knowledge.
- [**typescript-pro**](categories/02-language-specialists/typescript-pro.md) - TypeScript specialist
- [**sql-pro**](categories/02-language-specialists/sql-pro.md) - Database query expert
- [**swift-expert**](categories/02-language-specialists/swift-expert.md) - iOS and macOS specialist
- [**vue-expert**](categories/02-language-specialists/vue-expert.md) - Vue 3 Composition API expert
- [**angular-architect**](categories/02-language-specialists/angular-architect.md) - Angular 15+ enterprise patterns expert
- [**cpp-pro**](categories/02-language-specialists/cpp-pro.md) - C++ performance expert
- [**csharp-developer**](categories/02-language-specialists/csharp-developer.md) - .NET ecosystem specialist
- [**django-developer**](categories/02-language-specialists/django-developer.md) - Django 4+ web development expert
- [**dotnet-core-expert**](categories/02-language-specialists/dotnet-core-expert.md) - .NET 8 cross-platform specialist
- [**dotnet-framework-4.8-expert**](categories/02-language-specialists/dotnet-framework-4.8-expert.md) - .NET Framework legacy enterprise specialist
- [**elixir-expert**](categories/02-language-specialists/elixir-expert.md) - Elixir and OTP fault-tolerant systems expert
- [**expo-react-native-expert**](categories/02-language-specialists/expo-react-native-expert.md) - Expo and React Native mobile development expert
- [**fastapi-developer**](categories/02-language-specialists/fastapi-developer.md) - Modern async Python API framework expert
- [**flutter-expert**](categories/02-language-specialists/flutter-expert.md) - Flutter 3+ cross-platform mobile expert
- [**golang-pro**](categories/02-language-specialists/golang-pro.md) - Go concurrency specialist
- [**java-architect**](categories/02-language-specialists/java-architect.md) - Enterprise Java expert
- [**javascript-pro**](categories/02-language-specialists/javascript-pro.md) - JavaScript development expert
- [**powershell-5.1-expert**](categories/02-language-specialists/powershell-5.1-expert.md) - Windows PowerShell 5.1 and full .NET Framework automation specialist
- [**powershell-7-expert**](categories/02-language-specialists/powershell-7-expert.md) - Cross-platform PowerShell 7+ automation and modern .NET specialist
- [**kotlin-specialist**](categories/02-language-specialists/kotlin-specialist.md) - Modern JVM language expert
- [**laravel-specialist**](categories/02-language-specialists/laravel-specialist.md) - Laravel 10+ PHP framework expert
- [**nextjs-developer**](categories/02-language-specialists/nextjs-developer.md) - Next.js 14+ full-stack specialist
- [**node-specialist**](categories/02-language-specialists/node-specialist.md) - Node.js specialist
- [**php-pro**](categories/02-language-specialists/php-pro.md) - PHP web development expert
- [**python-pro**](categories/02-language-specialists/python-pro.md) - Python ecosystem master
- [**rails-expert**](categories/02-language-specialists/rails-expert.md) - Rails 8.1 rapid development expert
- [**react-specialist**](categories/02-language-specialists/react-specialist.md) - React 18+ modern patterns expert
- [**rust-engineer**](categories/02-language-specialists/rust-engineer.md) - Systems programming expert
- [**spring-boot-engineer**](categories/02-language-specialists/spring-boot-engineer.md) - Spring Boot 3+ microservices expert
- [**symfony-specialist**](categories/02-language-specialists/symfony-specialist.md) - Symfony 6+/7+/8+ PHP framework and Doctrine ORM expert
### [03. 基础设施](categories/03-infrastructure/)
**Plugin:** `voltagent-infra`
DevOps、云与部署领域专家。
- [**azure-infra-engineer**](categories/03-infrastructure/azure-infra-engineer.md) - Azure 基础设施与 Az PowerShell 自动化专家
- [**cloud-architect**](categories/03-infrastructure/cloud-architect.md) - AWS/GCP/Azure 专家
- [**database-administrator**](categories/03-infrastructure/database-administrator.md) - 数据库管理专家
- [**docker-expert**](categories/03-infrastructure/docker-expert.md) - Docker 容器化与优化专家
- [**deployment-engineer**](categories/03-infrastructure/deployment-engineer.md) - 部署自动化专家
- [**devops-engineer**](categories/03-infrastructure/devops-engineer.md) - CI/CD 与自动化专家
- [**devops-incident-responder**](categories/03-infrastructure/devops-incident-responder.md) - DevOps 事件管理
- [**incident-responder**](categories/03-infrastructure/incident-responder.md) - 系统事件响应专家
- [**kubernetes-specialist**](categories/03-infrastructure/kubernetes-specialist.md) - 容器编排专家
- [**network-engineer**](categories/03-infrastructure/network-engineer.md) - 网络基础设施专家
- [**platform-engineer**](categories/03-infrastructure/platform-engineer.md) - 平台架构专家
- [**security-engineer**](categories/03-infrastructure/security-engineer.md) - 基础设施安全专家
- [**sre-engineer**](categories/03-infrastructure/sre-engineer.md) - 站点可靠性工程(SRE)专家
- [**terraform-engineer**](categories/03-infrastructure/terraform-engineer.md) - 基础设施即代码(IaC)专家
- [**terragrunt-expert**](categories/03-infrastructure/terragrunt-expert.md) - Terragrunt 编排与 DRY IaC 专家
- [**windows-infra-admin**](categories/03-infrastructure/windows-infra-admin.md) - Active Directory、DNS、DHCP 与 GPO 自动化专家
### [04. 质量与安全](categories/04-quality-security/)
**Plugin:** `voltagent-qa-sec`
测试、安全与代码质量专家。
- [**accessibility-tester**](categories/04-quality-security/accessibility-tester.md) - 无障碍(A11y)合规专家
- [**ad-security-reviewer**](categories/04-quality-security/ad-security-reviewer.md) - Active Directory 安全与 GPO 审计专家
- [**ai-writing-auditor**](categories/04-quality-security/ai-writing-auditor.md) - AI 写作模式检测与改写专家
- [**architect-reviewer**](categories/04-quality-security/architect-reviewer.md) - 架构评审专家
- [**chaos-engineer**](categories/04-quality-security/chaos-engineer.md) - 系统韧性测试专家
- [**code-reviewer**](categories/04-quality-security/code-reviewer.md) - 代码质量守护者
- [**compliance-auditor**](categories/04-quality-security/compliance-auditor.md) - 监管合规专家
- [**debugger**](categories/04-quality-security/debugger.md) - 高级调试专家
- [**gdpr-ccpa-compliance**](categories/04-quality-security/gdpr-ccpa-compliance.md) - GDPR 与 CCPA 隐私合规专家
- [**error-detective**](categories/04-quality-security/error-detective.md) - 错误分析与解决专家
- [**penetration-tester**](categories/04-quality-security/penetration-tester.md) - 道德黑客专家
- [**performance-engineer**](categories/04-quality-security/performance-engineer.md) - 性能优化专家
- [**powershell-security-hardening**](categories/04-quality-security/powershell-security-hardening.md) - PowerShell 安全加固与合规专家
- [**qa-expert**](categories/04-quality-security/qa-expert.md) - 测试自动化专家
- [**security-auditor**](categories/04-quality-security/security-auditor.md) - 安全漏洞专家
- [**test-automator**](categories/04-quality-security/test-automator.md) - 测试自动化框架专家
- [**ui-ux-tester**](categories/04-quality-security/ui-ux-tester.md) - 详尽文档化流程 UI 测试专家
### [05. 数据与 AI](categories/05-data-ai/)
**Plugin:** `voltagent-data-ai`
数据工程、机器学习(ML)与 AI 专家。
- [**ai-engineer**](categories/05-data-ai/ai-engineer.md) - AI 系统设计与部署专家
- [**data-analyst**](categories/05-data-ai/data-analyst.md) - 数据洞察与可视化专家
- [**data-engineer**](categories/05-data-ai/data-engineer.md) - 数据管道架构师
- [**data-scientist**](categories/05-data-ai/data-scientist.md) - 分析与洞察专家
- [**database-optimizer**](categories/05-data-ai/database-optimizer.md) - 数据库性能专家
- [**llm-architect**](categories/05-data-ai/llm-architect.md) - 大语言模型(LLM)架构师
- [**machine-learning-engineer**](categories/05-data-ai/machine-learning-engineer.md) - 机器学习系统专家
- [**ml-engineer**](categories/05-data-ai/ml-engineer.md) - 机器学习专家
- [**mlops-engineer**](categories/05-data-ai/mlops-engineer.md) - MLOps 与模型部署专家
- [**nlp-engineer**](categories/05-data-ai/nlp-engineer.md) - 自然语言处理(NLP)专家
- [**postgres-pro**](categories/05-data-ai/postgres-pro.md) - PostgreSQL 数据库专家
- [**prompt-engineer**](categories/05-data-ai/prompt-engineer.md) - 提示词优化专家
- [**reinforcement-learning-engineer**](categories/05-data-ai/reinforcement-learning-engineer.md) - 强化学习与智能体训练专家
### [06. 开发者体验](categories/06-developer-experience/)
**Plugin:** `voltagent-dev-exp`
工具链与开发者生产力专家。
- [**build-engineer**](categories/06-developer-experience/build-engineer.md) - 构建系统专家
- [**cli-developer**](categories/06-developer-experience/cli-developer.md) - 命令行工具开发者
- [**dependency-manager**](categories/06-developer-experience/dependency-manager.md) - 包与依赖管理专家
- [**documentation-engineer**](categories/06-developer-experience/documentation-engineer.md) - 技术文档专家
- [**dx-optimizer**](categories/06-developer-experience/dx-optimizer.md) - 开发者体验(DX)优化专家
- [**git-workflow-manager**](categories/06-developer-experience/git-workflow-manager.md) - Git 工作流与分支管理专家
- [**legacy-modernizer**](categories/06-developer-experience/legacy-modernizer.md) - 遗留代码现代化专家
- [**mcp-developer**](categories/06-developer-experience/mcp-developer.md) - 模型上下文协议(MCP)专家
- [**powershell-ui-architect**](categories/06-developer-experience/powershell-ui-architect.md) - PowerShell UI/UX 专家,涵盖 WinForms、WPF、Metro 框架与 TUI
- [**powershell-module-architect**](categories/06-developer-experience/powershell-module-architect.md) - PowerShell 模块与配置文件架构专家
- [**readme-generator**](categories/06-developer-experience/readme-generator.md) - 仓库 README 生成专家
- [**refactoring-specialist**](categories/06-developer-experience/refactoring-specialist.md) - 代码重构专家
- [**slack-expert**](categories/06-developer-experience/slack-expert.md) - Slack 平台与 @slack/bolt 专家
- [**tooling-engineer**](categories/06-developer-experience/tooling-engineer.md) - 开发者工具链专家
- [**visual-asset-generator**](categories/06-developer-experience/visual-asset-generator.md) - 视觉资产生成专家,通过 prompt-to-asset MCP 支持 30+ 图像模型
### [07. 专业领域](categories/07-specialized-domains/)
**Plugin:** `voltagent-domains`
特定领域技术专家。
- [**api-documenter**](categories/07-specialized-domains/api-documenter.md) - API 文档专家
- [**blockchain-developer**](categories/07-specialized-domains/blockchain-developer.md) - Web3 与加密货币专家
- [**embedded-systems**](categories/07-specialized-domains/embedded-systems.md) - 嵌入式与实时系统专家
- [**fintech-engineer**](categories/07-specialized-domains/fintech-engineer.md) - 金融科技专家
- [**game-developer**](categories/07-specialized-domains/game-developer.md) - 游戏开发专家
- [**healthcare-admin**](categories/07-specialized-domains/healthcare-admin.md) - 医疗管理专家,包含 51 个子智能体,覆盖收入周期、合规、质量、临床运营、医疗 IT 与支付方关系
- [**hipaa-compliance**](categories/07-specialized-domains/hipaa-compliance.md) - 面向医疗 SaaS 供应商的 HIPAA 合规专家
- [**iot-engineer**](categories/07-specialized-domains/iot-engineer.md) - IoT 系统开发者
- [**m365-admin**](categories/07-specialized-domains/m365-admin.md) - Microsoft 365、Exchange Online、Teams 与 SharePoint 管理专家
- [**mobile-app-developer**](categories/07-specialized-domains/mobile-app-developer.md) - 移动应用专家
- [**payment-integration**](categories/07-specialized-domains/payment-integration.md) - 支付系统专家
- [**quant-analyst**](categories/07-specialized-domains/quant-analyst.md) - 量化分析专家
- [**risk-manager**](categories/07-specialized-domains/risk-manager.md) - 风险评估与管理专家
- [**seo-specialist**](categories/07-specialized-domains/seo-specialist.md) - 搜索引擎优化(SEO)专家
### [08. 商业与产品](categories/08-business-product/)
**插件:** `voltagent-biz`
产品管理与商业分析。
- [**assumption-mapping**](categories/08-business-product/assumption-mapping.md) - 产品假设风险与验证专家
- [**backlog-grooming**](categories/08-business-product/backlog-grooming.md) - 敏捷待办清单梳理专家
- [**business-analyst**](categories/08-business-product/business-analyst.md) - 需求分析专家
- [**content-marketer**](categories/08-business-product/content-marketer.md) - 内容营销专家
- [**customer-success-manager**](categories/08-business-product/customer-success-manager.md) - 客户成功专家
- [**growth-loops**](categories/08-business-product/growth-loops.md) - 增长循环与 PLG(产品驱动增长)机制专家
- [**legal-advisor**](categories/08-business-product/legal-advisor.md) - 法律与合规专家
- [**license-engineer**](categories/08-business-product/license-engineer.md) - 软件许可与合规系统专家
- [**product-manager**](categories/08-business-product/product-manager.md) - 产品战略专家
- [**project-manager**](categories/08-business-product/project-manager.md) - 项目管理专家
- [**sales-engineer**](categories/08-business-product/sales-engineer.md) - 技术销售专家
- [**scrum-master**](categories/08-business-product/scrum-master.md) - 敏捷方法论专家
- [**technical-writer**](categories/08-business-product/technical-writer.md) - 技术文档专家
- [**ux-researcher**](categories/08-business-product/ux-researcher.md) - 用户研究专家
- [**wordpress-master**](categories/08-business-product/wordpress-master.md) - WordPress 开发与优化专家
- [**content-quality-editor**](categories/08-business-product/content-quality-editor.md) - 借助 unslop 在发布前去除 AI 写作痕迹的 AI 内容质量专家
### [09. 元编程与编排](categories/09-meta-orchestration/)
**插件:** `voltagent-meta`
智能体协调与元编程。
- [**airis-mcp-gateway**](https://github.com/agiletec-inc/airis-mcp-gateway) - 基于 Docker 的 MCP 多路复用器,将 60+ 个工具聚合为 7 个元工具,将上下文 token 使用量降低 97%。一条命令即可启动,按需自动启用服务器
- [**moai-adk**](https://github.com/modu-ai/moai-adk) - 以 SPEC 为先的 Agentic Development Kit,编排 24 个专项智能体,强制执行 Plan→Run→Sync 工作流、TRUST 5 质量门禁、52 项领域专属技能,并支持 16 种语言的项目
- [**agent-installer**](categories/09-meta-orchestration/agent-installer.md) - 通过 GitHub 浏览并安装本仓库中的智能体
- [**agent-organizer**](categories/09-meta-orchestration/agent-organizer.md) - 多智能体协调器
- [**codebase-orchestrator**](categories/09-meta-orchestration/codebase-orchestrator.md) - 安全重构治理编排器
- [**context-manager**](categories/09-meta-orchestration/context-manager.md) - 上下文优化专家
- [**error-coordinator**](categories/09-meta-orchestration/error-coordinator.md) - 错误处理与恢复专家
- [**it-ops-orchestrator**](categories/09-meta-orchestration/it-ops-orchestrator.md) - IT 运维工作流编排专家
- [**knowledge-synthesizer**](categories/09-meta-orchestration/knowledge-synthesizer.md) - 知识聚合专家
- [**multi-agent-coordinator**](categories/09-meta-orchestration/multi-agent-coordinator.md) - 高级多智能体编排
- [**performance-monitor**](categories/09-meta-orchestration/performance-monitor.md) - 智能体性能优化
- [**pied-piper**](https://github.com/sathish316/pied-piper/) - 为重复的 SDLC 工作流编排 AI 子智能体团队
- [**task-distributor**](categories/09-meta-orchestration/task-distributor.md) - 任务分配专家
- [**taskade**](https://github.com/taskade/mcp) - 集成 MCP 的 AI 驱动工作区,具备自主智能体、实时协作与工作流自动化
- [**workflow-orchestrator**](categories/09-meta-orchestration/workflow-orchestrator.md) - 复杂工作流自动化
### [10. 研究与分析](categories/10-research-analysis/)
**插件:** `voltagent-research`
研究、检索与分析专家。
- [**ab-test-analysis**](categories/10-research-analysis/ab-test-analysis.md) - A/B 测试分析与上线/不上线决策专家
- [**cohort-analysis**](categories/10-research-analysis/cohort-analysis.md) - 用户群组留存与行为分析专家
- [**first-principles-thinking**](categories/10-research-analysis/first-principles-thinking.md) - 第一性原理问题解决专家
- [**research-analyst**](categories/10-research-analysis/research-analyst.md) - 综合研究专家
- [**search-specialist**](categories/10-research-analysis/search-specialist.md) - 高级信息检索专家
- [**trend-analyst**](categories/10-research-analysis/trend-analyst.md) - 新兴趋势与预测专家
- [**competitive-analyst**](categories/10-research-analysis/competitive-analyst.md) - 竞争情报专家
- [**market-researcher**](categories/10-research-analysis/market-researcher.md) - 市场分析与消费者洞察
- [**project-idea-validator**](categories/10-research-analysis/project-idea-validator.md) - 严苛的产品创意 go/no-go 验证器
- [**data-researcher**](categories/10-research-analysis/data-researcher.md) - 数据发现与分析专家
- [**scientific-literature-researcher**](categories/10-research-analysis/scientific-literature-researcher.md) - 通过 [BGPT MCP](https://github.com/connerlambden/bgpt-mcp) 进行科学论文检索与证据综合
## 🤖 理解子智能体(Subagents
子智能体(Subagents)是专门的 AI 助手,通过提供特定任务领域的专业能力来增强 Claude Code 的功能。它们作为专用助手,当 Claude Code 遇到特定类型的工作时可以调用。
### 子智能体的特别之处
**独立上下文窗口**
每个子智能体都在各自隔离的上下文空间中运行,避免不同任务之间的相互干扰,并保持主对话线程的清晰。
**领域专属智能**
子智能体配备了针对其专业领域精心设计的指令,从而在专项任务上表现更出色。
**跨项目共享**
创建子智能体后,你可以在多个项目中使用它,并与团队成员共享,以确保开发实践的一致性。
**细粒度工具权限**
你可以为每个子智能体配置特定的工具访问权限,从而精细控制不同类型任务可用的能力。
### 核心优势
- **内存效率**:隔离的上下文避免主对话被任务专属细节淹没
- **更高准确性**:专项提示词与配置能在特定领域带来更优结果
- **工作流一致性**:在团队范围内共享子智能体,确保常见任务的处理方式统一
- **安全控制**:可根据子智能体类型与用途限制工具访问
### 子智能体入门
**1. 访问子智能体管理器**
```bash
/agents
```
**2. 创建你的子智能体**
- 选择项目专属或全局子智能体
- 让 Claude 生成初始版本,再按需求调整
- 详细描述子智能体的用途与触发条件
- 配置工具访问权限(留空则继承所有可用工具)
- 使用内置编辑器自定义系统提示词(按 `e`
**3. 部署与使用**
子智能体创建后立即可用。Claude Code 会在合适时自动调用,你也可以显式请求其协助:
```
> Have the code-reviewer subagent analyze my latest commits
```
### 子代理存储位置
| 类型 | 路径 | 可用范围 | 优先级 |
|------|------|----------|--------|
| 项目子代理 (Project Subagents) | `.claude/agents/` | 仅当前项目 | 更高 |
| 全局子代理 (Global Subagents) | `~/.claude/agents/` | 所有项目 | 更低 |
注意:发生命名冲突时,项目专属子代理会覆盖全局子代理。
## 📖 子代理结构
每个子代理都遵循标准化模板:
```yaml
---
name: subagent-name
description: When this agent should be invoked
tools: Read, Write, Edit, Bash, Glob, Grep
model: sonnet
---
You are a [role description and expertise areas]...
[Agent-specific checklists, patterns, and guidelines]...
## Communication Protocol
Inter-agent communication specifications...
## Development Workflow
Structured implementation phases...
```
### 工具分配理念
### 智能模型路由
每个子代理都包含 `model` 字段,会自动将其路由到合适的 Claude 模型——在质量与成本之间取得平衡:
| 模型 | 使用场景 | 示例 |
|------|----------|------|
| `opus` | 深度推理——架构评审、安全审计、金融逻辑 | `security-auditor``architect-reviewer``fintech-engineer` |
| `sonnet` | 日常编码——编写、调试、重构 | `python-pro``backend-developer``devops-engineer` |
| `haiku` | 快速任务——文档、搜索、依赖检查 | `documentation-engineer``seo-specialist``build-engineer` |
你可以在其 frontmatter 中编辑 `model` 字段来覆盖任意代理的模型。将 `model: inherit` 设置为使用主对话正在使用的任意模型。
### 工具分配理念
每个子代理的 `tools` 字段指定 Claude Code 内置工具,并按其角色进行优化:
- **只读代理**(审查者、审计者):`Read, Grep, Glob` - 分析而不修改
- **研究代理**(分析师、研究员):`Read, Grep, Glob, WebFetch, WebSearch` - 收集信息
- **代码编写代理**(开发者、工程师):`Read, Write, Edit, Bash, Glob, Grep` - 创建并执行
- **文档代理**(写作者、文档撰写者):`Read, Write, Edit, Glob, Grep, WebFetch, WebSearch` - 结合研究撰写文档
每个代理仅拥有所需的最小权限。你可以向 `tools` 字段添加 MCP 服务器或外部工具来扩展代理。
## 🧰 工具
### [subagent-catalog](tools/subagent-catalog/)
用于浏览并从此目录获取子代理的 Claude Code 技能。
| 命令 | 说明 |
|------|------|
| `/subagent-catalog:search <query>` | 按名称、描述或类别查找代理 |
| `/subagent-catalog:fetch <name>` | 获取完整代理定义 |
| `/subagent-catalog:list` | 浏览所有类别 |
| `/subagent-catalog:invalidate` | 刷新缓存 |
**安装:**
```bash
cp -r tools/subagent-catalog ~/.claude/commands/
```
## 🤝 贡献
欢迎贡献!请参阅 [CONTRIBUTING.md](CONTRIBUTING.md) 了解指南。
- 通过 PR 提交新的子代理
- 改进现有定义
- 报告问题和缺陷
## 贡献者 ♥️ 致谢
![Contributors](https://contrib.rocks/image?repo=voltagent/awesome-claude-code-subagents&max=500&columns=20&anon=1)
## 📄 许可证
MIT License - see [LICENSE](LICENSE)
本仓库是由维护者与社区共同贡献的子代理定义精选合集。所有子代理均按“原样”提供,不作任何担保。我们不审计也不保证任何子代理的安全性或正确性。使用前请自行审查,维护者对其使用引发的任何问题不承担任何责任。
如果你发现所列子代理存在问题,或希望移除你的贡献,请 [open an issue](https://github.com/VoltAgent/awesome-claude-code-subagents/issues) and we'll address it promptly.
[codex-badge]: https://img.shields.io/github/stars/VoltAgent/awesome-codex-subagents?style=classic&label=Codex%20Subagents&color=000000&logo=data:image/svg%2bxml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCIgZmlsbD0id2hpdGUiPjxwYXRoIGQ9Ik0yMi4yODIgOS44MjFhNS45ODUgNS45ODUgMCAwIDAtLjUxNi00LjkxIDYuMDQ2IDYuMDQ2IDAgMCAwLTYuNTEtMi45QTYuMDY1IDYuMDY1IDAgMCAwIDQuOTgxIDQuMThhNS45ODUgNS45ODUgMCAwIDAtMy45OTggMi45IDYuMDQ2IDYuMDQ2IDAgMCAwIC43NDMgNy4wOTcgNS45OCA1Ljk4IDAgMCAwIC41MSA0LjkxMSA2LjA1MSA2LjA1MSAwIDAgMCA2LjUxNSAyLjlBNS45ODUgNS45ODUgMCAwIDAgMTMuMjYgMjRhNi4wNTYgNi4wNTYgMCAwIDAgNS43NzItNC4yMDYgNS45OSA1Ljk5IDAgMCAwIDMuOTk3LTIuOSA2LjA1NiA2LjA1NiAwIDAgMC0uNzQ3LTcuMDczek0xMy4yNiAyMi40M2E0LjQ3NiA0LjQ3NiAwIDAgMS0yLjg3Ni0xLjA0bC4xNDEtLjA4MSA0Ljc3OS0yLjc1OGEuNzk1Ljc5NSAwIDAgMCAuMzkyLS42ODF2LTYuNzM3bDIuMDIgMS4xNjhhLjA3MS4wNzEgMCAwIDEgLjAzOC4wNTJ2NS41ODNhNC41MDQgNC41MDQgMCAwIDEtNC40OTQgNC40OTR6TTMuNiAxOC4zMDRhNC40NyA0LjQ3IDAgMCAxLS41MzUtMy4wMTRsLjE0Mi4wODUgNC43ODMgMi43NTlhLjc3MS43NzEgMCAwIDAgLjc4IDBsNS44NDMtMy4zNjl2Mi4zMzJhLjA4LjA4IDAgMCAxLS4wMzMuMDYyTDkuNzQgMTkuOTVhNC41IDQuNSAwIDAgMS02LjE0LTEuNjQ2ek0yLjM0IDcuODk2YTQuNDg1IDQuNDg1IDAgMCAxIDIuMzY2LTEuOTczVjExLjZhLjc2Ni43NjYgMCAwIDAgLjM4OC42NzZsNS44MTUgMy4zNTUtMi4wMiAxLjE2OGEuMDc2LjA3NiAwIDAgMS0uMDcxIDBsLTQuODMtMi43ODZBNC41MDQgNC41MDQgMCAwIDEgMi4zNCA3Ljg3MnptMTYuNTk3IDMuODU1bC01LjgzMy0zLjM4N0wxNS4xMTkgNy4yYS4wNzYuMDc2IDAgMCAxIC4wNzEgMGw0LjgzIDIuNzkxYTQuNDk0IDQuNDk0IDAgMCAxLS42NzYgOC4xMDV2LTUuNjc4YS43OS43OSAwIDAgMC0uNDA3LS42Njd6bTIuMDEtMy4wMjNsLS4xNDEtLjA4NS00Ljc3NC0yLjc4MmEuNzc2Ljc3NiAwIDAgMC0uNzg1IDBMOS40MDkgOS4yM1Y2Ljg5N2EuMDY2LjA2NiAwIDAgMSAuMDI4LS4wNjFsNC44My0yLjc4N2E0LjUgNC41IDAgMCAxIDYuNjggNC42NnptLTEyLjY0IDQuMTM1bC0yLjAyLTEuMTY0YS4wOC4wOCAwIDAgMS0uMDM4LS4wNTdWNi4wNzVhNC41IDQuNSAwIDAgMSA3LjM3NS0zLjQ1M2wtLjE0Mi4wOEw4LjcwNCA1LjQ2YS43OTUuNzk1IDAgMCAwLS4zOTMuNjgxem0xLjA5Ny0yLjM2NWwyLjYwMi0xLjUgMi42MDcgMS41djIuOTk5bC0yLjU5NyAxLjUtMi42MDctMS41eiIvPjwvc3ZnPg==
[codex-link]: https://github.com/VoltAgent/awesome-codex-subagents