Sub-agentes: uma ferramenta para adicionar e gerenciar subagentes de IA para o Claude Code

O Sub-agents é uma ferramenta de interface de linha de comando (CLI) projetada para aprimorar o ambiente de desenvolvimento do Claude Code da Anthropic. Ela permite que os desenvolvedores adicionem, gerenciem e criem facilmente "subagentes" de IA dedicados a tarefas de programação específicas. Esses subagentes são assistentes de IA pré-configurados, cada um deles proficiente em uma área, como revisão de código, teste, depuração, documentação ou desenvolvimento de API. O conceito central da ferramenta é a "combinação de especialistas", ou seja, o uso de vários agentes altamente especializados para trabalhar em conjunto, em vez de depender de uma IA genérica para lidar com tudo. A vantagem disso é que cada agente opera em um contexto isolado, com seus próprios avisos de sistema e conjunto de ferramentas especializadas, o que melhora a precisão e a eficiência das tarefas e reduz as "alucinações" que podem ocorrer quando uma IA de uso geral está trabalhando em tarefas complexas. Os subagentes são projetados para simplificar e automatizar os fluxos de trabalho de desenvolvimento, fornecendo agentes profissionais prontos para uso e a flexibilidade para criar agentes personalizados.

Lista de funções

• Agentes especializados em IAAgente de desenvolvimento: fornece uma variedade de agentes pré-construídos, cada um deles especialista em uma área específica de desenvolvimento.
• Uso de configuração zeroAgentes pré-construídos funcionam imediatamente, sem necessidade de configuração adicional.
• A altura pode ser personalizadaAgente personalizado: permite que os desenvolvedores criem agentes personalizados que atendam às suas necessidades específicas de fluxo de trabalho.
• Gerenciamento inteligente de contextoCada agente é executado em um contexto isolado, evitando a interferência entre diferentes tarefas.
• Integração com o Context-ForgePode ser perfeitamente integrado comcontext-forgeOs projetos e seus documentos PRP (Planejamento de Relacionamento com o Projeto) são usados em conjunto.
• interface de linha de comandoInstalação, inicialização, visualização de listas, ativação/desativação e remoção de agentes podem ser feitas com comandos simples.
• Aplicação de procuração independenteSuporte para a execução de agentes independentemente do ambiente do Claude Code, facilitando a automação e a criação de scripts.
• Painel de controle da WebInterface da Web: fornece uma interface da Web para monitoramento e gerenciamento em tempo real do status do agente, histórico de tarefas e métricas de desempenho.
• sistema de ganchosPermite a definição de ações que são acionadas automaticamente em eventos específicos (por exemplo, edição de documentos, conclusão de tarefas) para automação do fluxo de trabalho.
• Duas faixas de instalaçãoSuporte para instalações de agentes em todo o usuário (disponível para todos os projetos) e em todo o projeto (disponível apenas para o projeto atual).

Usando a Ajuda

O Sub-agents é uma poderosa ferramenta de linha de comando projetada para aprimorar o Claude Code com uma variedade de subagentes de IA especializados. A seguir, você encontrará detalhes sobre como instalar e usar essa ferramenta e como operar seus principais recursos.

Processo de instalação

Você pode instalar os subagentes de várias maneiras, mas a maneira mais recomendada é usar o NPM.

1. instalação do NPM (recomendada)
Abra seu terminal e execute o seguinte comando para a instalação global:

npm install -g @webdevtoday/claude-agents

2. instalação do fio
Se preferir usar o Yarn, você pode usar o seguinte comando:

yarn global add @webdevtoday/claude-agents```
**3. 从源码安装**
你也可以直接从GitHub克隆源码进行安装，这适用于希望进行二次开发的用户：
```bash
git clone https://github.com/webdevtodayjason/sub-agents.git
cd sub-agents
npm install
npm link

Após a conclusão da instalaçãoclaude-agentsestará disponível em seu terminal.

Primeiros passos

Após uma instalação bem-sucedida, você pode acessar oinitInício rápido do comando.

Para novos projetos:
No diretório raiz do seu projeto, execute o seguinte comando para inicializar todos os agentes disponíveis:

claude-agents init

Você pode então usar olistpara ver todos os proxies disponíveis:

claude-agents list

Para projetos que já usam o Context-Forge:
Se o seu projeto já estiver usandocontext-forgeVocê pode usar uminitpara garantir a compatibilidade:

claude-agents init --respect-context-forge

Esse comando coloca de forma inteligente o comando proxy na seção.claude/commands/agents/para evitar conflitos com seus comandos existentes e atualizará com segurança o diretórioCLAUDE.mdDocumentação.

Funções principais

1. gerenciamento de agências
Os subagentes oferecem um conjunto completo de comandos para gerenciar o ciclo de vida do agente.

• Agente de instalaçãoInstalação interativa de um ou mais agentes: Você pode instalar interativamente um ou mais agentes.

  claude-agents install
  

  Ou instale todos os agentes disponíveis de uma só vez:

  claude-agents install --all
  

• Ver agenteLista de todos os agentes instalados.

  claude-agents list --installed
  

• Ativar/desativar proxyAgente: Você pode ativar ou desativar um agente a qualquer momento.

  claude-agents disable test-runner
  claude-agents enable test-runner
  

• Remover proxyRemover um agente que não é mais necessário.

  claude-agents remove debugger
  ```    或者进行批量卸载并清理相关文件：
  ```bash
  claude-agents uninstall --all --clean
  

2. uso de proxies no Claude Code
Há duas maneiras principais de invocar proxies no Claude Code:

• Comandos de barraCada agente está associado a um comando de barra para invocação rápida. Por exemplo, para chamar o agente de revisão de código, basta digitar:

  /review
  ```    对于需要参数的代理，可以在命令后附带参数：
  

  /depurar problema de login

• Ferramenta de tarefas: Você também pode usarTaskferramentas para executar instruções mais complexas.

  Task("project-planner: analyze all PRPs and create sprint plan")
  

3. agentes operacionais autônomos
Esse é um recurso muito avançado que permite que você use agentes diretamente em scripts de automação ou fluxos de trabalho sem precisar abrir o Claude Code.

# 使用内联任务运行
claude-agents run marketing-writer --task "Write launch announcement for v2.0"
# 从文件读取任务
claude-agents run api-developer --file api-spec.md
# 以交互模式运行
claude-agents run tdd-specialist --interactive```
**4. 创建自定义代理**
如果预设的代理不能满足你的需求，你可以轻松创建自己的代理。
运行以下命令，工具会通过交互式问答引导你完成创建过程：
```bash
claude-agents create

Você será solicitado a definir o nome e a descrição do agente, bem como as ferramentas necessárias. Isso facilita muito a criação de assistentes de IA altamente personalizados.

5. usando o painel da Web
Para gerenciar e monitorar seus agentes de forma mais intuitiva, o Sub-agents oferece um painel de controle na Web.
Ativar o painel de controle:

claude-agents dashboard

Você também pode especificar o número da porta:

claude-agents dashboard --port 8080

No painel, você pode ver o status em tempo real, o histórico de execução de tarefas e as métricas de desempenho de todos os seus agentes e executar ações rapidamente.

Com as etapas acima, você pode se tornar proficiente no uso de subagentes para aumentar sua produtividade de desenvolvimento. Essa ferramenta melhora drasticamente a qualidade e a velocidade da geração, revisão e teste de código, dividindo grandes tarefas de desenvolvimento para especialistas em IA em diferentes áreas.

cenário do aplicativo

1. Revisão automatizada de código
   O desenvolvedor pode chamar ocode-reviewerAgentes que realizam análises abrangentes de qualidade, segurança e desempenho de códigos recém-enviados. O agente verifica automaticamente se o código segue as práticas recomendadas e sugere otimizações específicas, reduzindo assim o ônus da revisão manual.
2. Auxiliou na depuração e na correção de bugs
   Quando um bug complexo é encontrado, você pode iniciar odebuggerAgente. Forneça a ele mensagens de erro ou rastreamentos de pilha, e o agente ajudará a analisar a causa raiz do problema e tentará fornecer correções para acelerar a resolução do problema.
3. Prototipagem rápida
   Nos estágios iniciais de um projeto, vários agentes podem ser usados em combinação para criar rapidamente um protótipo de aplicativo. Por exemplo, use oproject-plannermódulos de função de planejamento.api-developergerando a interface de back-end.frontend-developerA criação de interfaces de front-end reduz drasticamente o tempo necessário para passar do conceito ao protótipo.
4. Gerar e atualizar a documentação técnica
   Escrever e manter a documentação pode ser uma tarefa que consome muito tempo.doc-writerresponder cantandoapi-documenterO agente pode gerar e atualizar automaticamente arquivos README, documentação de API (por exemplo, especificações OpenAPI) etc. com base no código e nos comentários, garantindo que a documentação esteja sincronizada com o código.
5. Desenvolvimento orientado a testes (TDD)
   tdd-specialistOs agentes podem ajudar os desenvolvedores a praticar o desenvolvimento orientado por testes. Antes de escrever o código funcional, você pode permitir que o agente crie casos de teste com base nos requisitos e, em seguida, o desenvolvedor pode escrever o código de implementação com base nesses testes.

QA

1. Qual é a diferença entre subagentes e o uso direto do Claude Code?
   Os subagentes não substituem o Claude Code, eles o aprimoram. Ele resolve o problema de uma única IA de uso geral que não consegue se destacar em todas as áreas, introduzindo o conceito de "subagentes especializados". Cada subagente se concentra em uma tarefa específica, como revisão ou depuração de código, em um ambiente isolado, o que torna os resultados mais precisos e evita a confusão contextual entre diferentes tarefas.
2. Tenho que pagar por cada agente individualmente?
   O próprio Sub-agents é uma ferramenta de código aberto gratuita. No entanto, ela depende do Claude Code para executar suas tarefas, portanto, você ainda precisa ter acesso ao Claude Code da Anthropic e pagar de acordo com seu uso. O uso de vários subagentes pode aumentar o consumo de tokens.
3. É complicado criar proxies personalizados?
   Sem complicações. A ferramenta fornece uma ferramenta de linha de comando interativaclaude-agents createEle o orienta no processo de criação, incluindo a definição do nome do agente, sua descrição funcional e as ferramentas necessárias. Tudo o que você precisa fazer é descrever as responsabilidades do agente em linguagem natural, sem precisar escrever códigos complexos.
4. Esses agentes podem trabalhar juntos?
   Sim. A ferramenta foi projetada com a ideia de ter vários agentes trabalhando juntos. Com o Hooks System, você pode configurar regras de automação que permitem que um agente acione outro agente quando ele concluir uma tarefa. Por exemplo, quando a edição de código é concluída, você pode acionar automaticamente o agentetest-runnerpara executar o teste.
5. Se eu instalar um agente globalmente, isso afetará todos os meus projetos?
   Sim. Os agentes podem ser instalados em dois escopos diferentes: o escopo do usuário (~/.claude/agents/) e o escopo do projeto (.claude/agents/). Os agentes instalados no escopo do usuário estão disponíveis em todos os seus projetos. Se você quiser que o agente atenda apenas a projetos específicos, poderá instalá-lo usando a opção--projectpara instalá-lo no escopo do projeto.