wehub/voltagent--awesome-claude-code-subagents
1
0
Fork 0
Code Issues Pull Requests Actions Deployments Models Agent Notes Packages Projects Releases Wiki Activity
Files
main
voltagent--awesome-claude-c…/README.md
T
wehub-resource-sync 213ddde66c docs: make Chinese README the default
2026-07-13 11:06:59 +00:00

32 KiB
Raw Permalink Blame History

Note

本文档由 WeHub 基于上游 README 翻译整理，属于社区翻译，非官方中文文档。
English · 原始项目 · 上游 README
原作者、版权与许可证归属以原始项目及本仓库 LICENSE 文件为准。

Group 32

精选 154+ 个 Claude Code 子代理（subagent），涵盖 10 大类别。

Awesome Subagent Count Last Update Discord

Awesome Claude Code Subagents

本仓库是 Claude Code 子代理（subagent）的权威合集，这些专用 AI 助手面向特定开发任务而设计。

关于贡献的说明： 我们不接受以推广产品、公司或个人项目为主要目的的 PR。子代理必须对 Claude Code 用户具有真实价值，且内容保持厂商中立。若希望在本社区展示你的项目，可改为赞助本仓库——这是在此展示你工作的官方途径。

Installation

As Claude Code Plugin (Recommended)

claude plugin marketplace add VoltAgent/awesome-claude-code-subagents
claude plugin install <plugin-name>

Examples:

claude plugin install voltagent-lang    # Language specialists
claude plugin install voltagent-infra   # Infrastructure & DevOps

See 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

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)

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)

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
Ego Lite Ego Lite 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.

👉 You can feature your product here and reach developers using AI coding agents like Claude Code, Codex, Gemini, and more.

Become a Sponsor

📚 Categories

01. Core Development

Plugin: voltagent-core-dev

Essential development subagents for everyday coding tasks.

02. Language Specialists

Plugin: voltagent-lang

Language-specific experts with deep framework knowledge.

03. 基础设施

Plugin: voltagent-infra

DevOps、云与部署领域专家。

04. 质量与安全

Plugin: voltagent-qa-sec

测试、安全与代码质量专家。

05. 数据与 AI

Plugin: voltagent-data-ai

数据工程、机器学习（ML）与 AI 专家。

06. 开发者体验

Plugin: voltagent-dev-exp

工具链与开发者生产力专家。

07. 专业领域

Plugin: voltagent-domains

特定领域技术专家。

08. 商业与产品

插件： voltagent-biz

产品管理与商业分析。

09. 元编程与编排

插件： voltagent-meta

智能体协调与元编程。

10. 研究与分析

插件： voltagent-research

研究、检索与分析专家。

🤖 理解子智能体（Subagents）

子智能体（Subagents）是专门的 AI 助手，通过提供特定任务领域的专业能力来增强 Claude Code 的功能。它们作为专用助手，当 Claude Code 遇到特定类型的工作时可以调用。

子智能体的特别之处

独立上下文窗口
每个子智能体都在各自隔离的上下文空间中运行，避免不同任务之间的相互干扰，并保持主对话线程的清晰。

领域专属智能
子智能体配备了针对其专业领域精心设计的指令，从而在专项任务上表现更出色。

跨项目共享
创建子智能体后，你可以在多个项目中使用它，并与团队成员共享，以确保开发实践的一致性。

细粒度工具权限
你可以为每个子智能体配置特定的工具访问权限，从而精细控制不同类型任务可用的能力。

核心优势

  • 内存效率：隔离的上下文避免主对话被任务专属细节淹没
  • 更高准确性：专项提示词与配置能在特定领域带来更优结果
  • 工作流一致性：在团队范围内共享子智能体，确保常见任务的处理方式统一
  • 安全控制：可根据子智能体类型与用途限制工具访问

子智能体入门

1. 访问子智能体管理器

/agents

2. 创建你的子智能体

  • 选择项目专属或全局子智能体
  • 让 Claude 生成初始版本，再按需求调整
  • 详细描述子智能体的用途与触发条件
  • 配置工具访问权限（留空则继承所有可用工具）
  • 使用内置编辑器自定义系统提示词（按 e）

3. 部署与使用 子智能体创建后立即可用。Claude Code 会在合适时自动调用，你也可以显式请求其协助：

> Have the code-reviewer subagent analyze my latest commits

子代理存储位置

类型 路径 可用范围 优先级
项目子代理 (Project Subagents) .claude/agents/ 仅当前项目 更高
全局子代理 (Global Subagents) ~/.claude/agents/ 所有项目 更低

注意：发生命名冲突时，项目专属子代理会覆盖全局子代理。

📖 子代理结构

每个子代理都遵循标准化模板：

---
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

用于浏览并从此目录获取子代理的 Claude Code 技能。

命令 说明
/subagent-catalog:search <query> 按名称、描述或类别查找代理
/subagent-catalog:fetch <name> 获取完整代理定义
/subagent-catalog:list 浏览所有类别
/subagent-catalog:invalidate 刷新缓存

安装：

cp -r tools/subagent-catalog ~/.claude/commands/

🤝 贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解指南。

  • 通过 PR 提交新的子代理
  • 改进现有定义
  • 报告问题和缺陷

贡献者 ♥️ 致谢

Contributors

📄 许可证

MIT License - see LICENSE

本仓库是由维护者与社区共同贡献的子代理定义精选合集。所有子代理均按“原样”提供，不作任何担保。我们不审计也不保证任何子代理的安全性或正确性。使用前请自行审查，维护者对其使用引发的任何问题不承担任何责任。

如果你发现所列子代理存在问题，或希望移除你的贡献，请 open an issue and we'll address it promptly.

Reference in New Issue View Git Blame Copy Permalink