Criador de Agentes

Uma habilidade para criar subagentes personalizados empacotados em plugins adequados. Esta habilidade gerencia todo o fluxo: coleta de requisitos, geração de uma persona rica a partir de até mesmo uma descrição de uma linha, criação da estrutura de pastas correta e, opcionalmente, criação de uma habilidade complementar que roteia automaticamente tarefas para o novo agente.

Quando usar

Use esta habilidade sempre que precisar de um "cérebro" dedicado e isolado para lidar com uma tarefa repetitiva específica, ou quando se encontrar colando repetidamente o mesmo prompt do sistema massivo ou restrições no chat principal. Criar um subagente dedicado mantém a conversa principal leve e focada.

Por que isso existe

O exemplo contribuído assume um layout de host no estilo Windows <appDataDir>\config\plugins\; não é um caminho universal para plugins Codex/Claude. Para que um subagente seja registrado e invocável corretamente, ele precisa estar dentro do diretório agents/ de um plugin com um plugin.json válido. Obter essa estrutura corretamente manualmente é tedioso e propenso a erros. Esta habilidade automatiza todo o processo para que o usuário possa ir de "Quero um agente que revise código" a um pacote de agente revisável. A ativação requer validação de esquema específica do host e uma verificação de invocação real.

Diretório de destino

Confirme primeiro o host de destino do usuário e seu esquema/caminho suportado. A distribuição Codex e Claude permanece intencionalmente bloqueada nos metadados desta habilidade até que o empacotamento compatível seja validado. Não remova esses bloqueios apenas porque uma pasta pode ser criada. O layout do exemplo legado é:

<appDataDir>\config\plugins\<plugin-name>\

Se o usuário quiser o agente dentro de um plugin existente, adicione a pasta do agente ao diretório agents/ desse plugin. Se nenhum plugin for especificado, crie um novo plugin chamado <agent-name>-plugin.

Antes de criar qualquer caminho, valide ambos <agent-name> e <plugin-name>:

• aceite apenas letras minúsculas, números e hifens únicos: ^[a-z0-9]+(-[a-z0-9]+)*$
• rejeite /, \, ., .., caminhos absolutos, espaços em branco, metacaracteres de shell e metacaracteres YAML
• resolva o caminho de destino final e verifique se ele permanece abaixo de <appDataDir>\config\plugins\
• pare e peça uma substituição segura em vez de limpar um nome suspeito silenciosamente

Fluxo de trabalho

Use as informações já fornecidas, faça escolhas de rascunho reversíveis de rotina e peça apenas o material que falta nos requisitos de host, propósito ou local. Criar uma persona não concede permissão para gerar agentes ou modificar a configuração global do host.

Etapa 1: Coletar requisitos

Faça as seguintes perguntas ao usuário, uma de cada vez (use a ferramenta ask_question onde for apropriado, ou pergunte de forma conversacional se o fluxo for natural):

1. Nome do Agente — Como este agente deve ser chamado?

   • Guia: curto, em minúsculas, com hifens (por exemplo, code-reviewer, sql-expert, test-writer)

2. Propósito — Para que serve este agente? (mesmo uma única linha serve)

   • Exemplo: "revisar código", "escrever consultas SQL", "gerar testes unitários"

3. Localização do Plugin — Isso deve ir para um plugin existente ou um novo?

   • Liste os plugins existentes do usuário de <appDataDir>\config\plugins\
   • Padrão: crie um novo plugin chamado <agent-name>-plugin

4. Habilidade Complementar — Devo também criar uma habilidade de roteamento que acione automaticamente este agente? (Crie apenas quando solicitado)

Etapa 2: Gerar a persona

Esta é a etapa mais importante. O usuário pode lhe dar uma frase como "para revisar código" — seu trabalho é expandir isso em uma persona rica e detalhada que torna o agente genuinamente excelente em seu trabalho.

Uma boa persona inclui:

• Identidade: Quem é o agente e em que ele se especializa
• Áreas de especialização: Domínios, tecnologias ou metodologias específicas que ele conhece
• Traços de personalidade: Como ele se comunica (por exemplo, direto, minucioso, cauteloso)
• Estilo de trabalho: Como ele aborda problemas passo a passo
• Formato de saída: Como são suas respostas (estruturadas, em prosa, etc.)
• Restrições: O que ele NÃO deve fazer ou o que deve ser delegado a outros
• Padrões de qualidade: Como é "bom trabalho" para este agente

Por exemplo, se o usuário disser "para revisar código", gere uma persona como:

Aja como um revisor de código cuidadoso que trabalha em várias linguagens e paradigmas. Você aborda cada revisão com três prioridades: correção em primeiro lugar, manutenibilidade em segundo, desempenho em terceiro. Você nunca aprova código que não entendeu completamente. Você sinaliza vulnerabilidades de segurança

…