Coleção de subagentes de código Claude: uma extensão de corpo inteligente de IA para aumentar a eficiência do desenvolvimento

A coleção de subagentes do Claude Code é um projeto de código aberto que fornece uma série de subagentes de IA projetados especificamente para o Claude Code, com o objetivo de aprimorar o fluxo de trabalho de desenvolvimento, trazendo especialistas com conhecimento de domínio específico. Essa coleção contém vários subagentes, cada um com experiência em um domínio específico, que podem ser invocados automaticamente com base no contexto ou explicitamente especificados pelo usuário quando necessário. Esses subagentes abrangem vários aspectos do desenvolvimento de software, incluindo design de arquitetura de back-end, desenvolvimento de front-end, otimização de banco de dados, revisão de código, auditoria de segurança e suporte especializado para várias linguagens de programação. Ao delegar tarefas aos agentes especializados mais adequados, os desenvolvedores podem resolver problemas complexos com mais eficiência e melhorar a qualidade do código e a velocidade de desenvolvimento. O projeto não só fornece subagentes predefinidos, mas também permite que os usuários criem e contribuam com novos subagentes com base em suas próprias necessidades, o que resulta em um ecossistema de ferramentas de desenvolvimento sempre em expansão e aprimorado.

Lista de funções

• chamada automáticaO Claude Code é capaz de selecionar e invocar automaticamente o subagente mais adequado com base nos requisitos da tarefa, palavras-chave, tipos de arquivo ou mensagens de erro.
• chamada explícitaOs usuários podem solicitar explicitamente o uso de um subagente específico para uma tarefa por meio de instruções em linguagem natural, por exemplo, "use ocode-reviewerVerifique minhas alterações recentes."
• especialista em domínioFornecimento de subagentes que abrangem várias áreas de tecnologia, incluindo, entre outras, as seguintes:
  • Desenvolvimento e arquiteturaComobackend-architect(Arquiteto de back-end),frontend-developer(Desenvolvedor front-end),mobile-developer(desenvolvedores de celulares), etc.
  • Especialista em linguagem de programaçãoComopython-pro(Especialista em Python),golang-pro(Ir para especialista),rust-pro(Especialista em ferrugem), etc.
  • Infraestrutura, operações e manutençãoComodevops-troubleshooter(Especialista em resolução de problemas de operações e manutenção),deployment-engineer(Engenheiro de implantação),cloud-architect(Arquiteto de nuvem), etc.
  • Qualidade e segurançaComocode-reviewer(revisor de código),security-auditor(Auditor de segurança),test-automator(Engenheiro de automação de testes), etc.
  • Dados e IAComodata-scientist(Cientista de dados),ai-engineer(Engenheiro de IA),ml-engineer(Engenheiro de aprendizado de máquina), etc.
  • específico do campoComoapi-documenter(redator da documentação da API),payment-integration(Especialista em integração de pagamentos),blockchain-developer(desenvolvedores de blockchain), etc.
  • negociação de criptomoedas: Fornecidocrypto-trader(Comerciante de criptomoedas),defi-strategist(DeFi Strategist) e uma série de outros especialistas.
• escalabilidadeOs usuários podem criar seus próprios subagentes em um formato especificado para atender a requisitos específicos do projeto e podem contribuir com novos subagentes para esse projeto.
• Instalação e configuração simplesclonagem: basta clonar o repositório localmente e subagendar o.mdA instalação é concluída com a cópia dos arquivos para o diretório especificado no Claude Code.

Usando a Ajuda

O núcleo deste projeto é ampliar os recursos do Claude Code, transformando-o de um assistente de IA de uso geral em uma equipe colaborativa de vários especialistas. Cada subagente é um perfil separado (em formato Markdown) que define a função, a especialização e o comportamento desse agente. Quando um usuário interage com o Claude Code, o sistema determina de forma inteligente qual especialista é mais adequado para lidar com a tarefa em questão e delega a tarefa a ele.

Processo de instalação

1. pré-condições::
   • Você precisa ter o Claude Code instalado e configurado localmente.
   • Você precisa acessar o diretório que contém o arquivo de configuração do agente do Claude Code, geralmente o diretório~/.claude/agents/.
2. armazém de clones::
   Abra um terminal ou uma ferramenta de linha de comando e use o comandogitpara clonar o repositório de código do projeto:

   git clone https://github.com/davepoon/claude-code-subagents-collection.git
   

3. Vá para o diretório do projeto::

   cd claude-code-subagents-collection
   

4. Cópia de arquivos subproxy::
   Coloque todos os perfis de subagentes (.md) copiados para o diretório proxy do Claude Code. Dependendo do seu sistema operacional, use o comando apropriado abaixo:
   • macOS/Linux:

     cp *.md ~/.claude/agents/
     

   • Windows (computador):

     copy *.md %USERPROFILE%\.claude\agents\
     

5. Verificar a instalação::
   Você pode confirmar que os arquivos foram copiados com êxito listando os arquivos no diretório proxy:

   ls ~/.claude/agents/
   

   Ou, no Windows, use o comando dir %USERPROFILE%\.claude\agents\. Você deve conseguir ver todos os arquivos copiados do passado.mdDocumentação.

6. Reiniciar o código de reclamação::
   Para que o Claude Code carregue esses novos subagentes, você precisa reiniciá-lo.

método operacional

Depois de instalado, você pode usar esses subagentes em seu desenvolvimento diário. Há duas maneiras principais de usá-los:

1. chamadas automáticas

Essa é a maneira mais comum e conveniente de usá-lo. Você só precisa apresentar seus requisitos ao Claude Code como de costume, e ele selecionará automaticamente o subagente mais adequado para executar a tarefa com base na sua descrição.

• Cenários de amostra::
  • Quando você terminar de escrever um novo recurso de autenticação de usuário, basta dizer ao Claude: "Acabei de implementar o recurso de autenticação de usuário".code-reviewerpara analisar a qualidade e a capacidade de manutenção do código ao chamar osecurity-auditorpara verificar se há vulnerabilidades de segurança.
  • Se você encontrar um erro ao executar seu código, como "My React component has aTypeError", o Claude chamará automaticamente odebuggerpara ajudá-lo a analisar e identificar o problema.
  • Ao perceber que uma determinada consulta ao banco de dados está lenta, você pode dizer: "Esta consulta está sendo executada lentamente".database-optimizerpara analisar a instrução de consulta e dar sugestões de otimização.

2. chamadas explícitas

Em alguns casos, você pode querer atribuir diretamente um especialista a uma tarefa específica. Nesse caso, você pode especificar o subagente a ser usado quando fizer a pergunta.

• Cenários de amostra::
  • Revisão do código: "Letcode-reviewerConfira meu último envio".
  • auditoria de segurança: "Por favorsecurity-auditorRevise este código de autenticação".
  • otimização do desempenho: "Letperformance-engineerpara otimizar essa função."

Crie seu próprio subagente

Se achar que um subagente existente não atende às suas necessidades, você pode criar o seu próprio.

1. Criação de documentos::
   Em seu diretório de projeto ou~/.claude/agents/crie um novo arquivo Markdown, cujo nome deve seryour-agent-name.mdPor exemplomy-database-expert.md.
2. Gravação de arquivos de configuração::
   O conteúdo do arquivo precisa seguir um formato específico, contendo umfrontmattere um prompt do sistema.

   ---
   name: your-subagent-name
   description: A clear description of when this subagent should be invoked.
   tools: tool1, tool2 # 可选，限制该代理能使用的工具
   ---
   This is the system prompt. You are a helpful assistant specializing in...
   

   • nameIdentificador exclusivo do subagente, usando letras minúsculas e hífens.
   • descriptionDescrição: descreve claramente a finalidade desse subagente, que é a base principal para que a Claude faça chamadas automatizadas.
   • tools (Opcional): especifica as ferramentas que esse agente pode usar, como leitura e gravação de arquivos.
   • Prompt do sistemaAgente: Defina em detalhes a função, os recursos, o estilo de atuação e a experiência desse agente. Você deve fornecer instruções específicas e exemplos de como ele deve agir aqui.

cenário do aplicativo

1. Desenvolvimento de novos recursos
   Quando uma equipe começa a desenvolver um novo recurso, vários subagentes podem ser usados sequencialmente ou em paralelo. Primeiro, é possível chamar o subagentebackend-architectpara projetar a interface da API e o modelo de dados. Em seguida, deixe afrontend-developerImplemente a interface de front-end com base no rascunho do projeto. Durante o processo de desenvolvimento, fique à vontade para perguntarcode-reviewerO código é revisado e, por fim, otest-automatorCrie casos de teste automatizados para garantir uma funcionalidade estável.
2. Otimização do desempenho do sistema
   Quando houver um gargalo de desempenho no aplicativo on-line, você poderá usar a funçãoperformance-engineerpara localizar problemas de desempenho no código. Se o problema estiver no banco de dados, você poderá usar ainda mais a funçãodatabase-optimizerpara analisar consultas lentas e otimizar os índices. Em caso de alocação incorreta dos recursos da nuvem, ocloud-architectÉ possível oferecer consultoria sobre otimização de custo e desempenho.
3. Solução de problemas de emergência
   No caso de um problema urgente no ambiente de produçãodevops-troubleshooterEle pode ajudar a analisar registros, monitorar dados e localizar rapidamente a causa raiz do problema. Se for constatado que se trata de um bug no código, odebuggerPode ajudar os desenvolvedores a se aprofundar no código para depuração e correção.
4. Modernização de sistemas legados
   Para projetos mais antigos.legacy-modernizerPode fornecer soluções de refatoração para ajudar os desenvolvedores a migrar gradualmente bases de código desatualizadas para pilhas de tecnologias modernas. Ele pode analisar as estruturas de código existentes, sugerir melhorias e gerar código parcialmente refatorado.

QA

1. P: Como esses subagentes são chamados pelo Claude Code?
   R: Há dois tipos de invocação. O primeiro é a invocação automática, o Claude Code determinará de forma inteligente qual subproxy deve ser usado com base no conteúdo da solicitação, no contexto, no tipo de arquivo e em outras informações. Por exemplo, quando você menciona "consulta ao banco de dados", ele pode chamar automaticamentedatabase-optimizer. A segunda é uma chamada explícita, que você pode especificar diretamente na solicitação, por exemplo, "Let thesecurity-auditorVerifique este código".
2. P: Se eu instalar vários subagentes com funcionalidade semelhante, como o Claude escolherá?
   R: A escolha do Claude depende muito do arquivo de configuração do subagente nodescriptionCampos. Quanto mais clara e específica for a descrição, mais precisamente o Claude conseguirá selecionar o agente mais adequado. Se a descrição for muito vaga ou sobreposta, poderá resultar em uma seleção imprecisa. Portanto, é importante escrever descrições claras para os subagentes personalizados.
3. P: Posso usar vários subagentes em combinação para concluir uma tarefa complexa?
   R: Sim, esse é o poder do Claude Code. O claude pode orquestrar automaticamente vários subagentes para trabalharem juntos. Por exemplo, um processo de desenvolvimento completo pode ser:backend-architectArquitetura de design -> python-proEscrever código -> code-reviewerCódigo de revisão -> security-auditorRealização de inspeções de segurança -> deployment-engineerResponsável pela implementação. Todo o processo pode ser coordenado automaticamente pelo Claude em segundo plano.