Ampliar o modo Agente com habilidades

Com as habilidades, você pode aprimorar os recursos do Modo Agente com experiência especializada e fluxos de trabalho personalizados. Elas são baseadas no padrão aberto Habilidades do agente.

Ao contrário dos arquivos AGENTS.md, as habilidades representam experiência sob demanda. Essa estrutura permite que o modo agente mantenha um grande número de recursos especializados, como migrar entre versões específicas de bibliotecas ou fazer um elemento combinável se adaptar a diferentes tamanhos de tela, sem sobrecarregar a janela de contexto imediato do modelo.

O modelo decide de forma autônoma quando usar uma habilidade com base na sua solicitação e na descrição dela. Quando uma habilidade relevante é identificada, o modelo busca dinamicamente as instruções e os recursos completos necessários para concluir a tarefa.

Para ativar uma skill sob demanda, peça ao agente para realizar uma tarefa relevante para a skill. Você também pode inserir @ na caixa de entrada para acionar uma skill específica.

Principais benefícios

  • Expertise compartilhada:agrupe fluxos de trabalho complexos (como o processo de revisão de solicitação de envio de uma equipe específica) em uma pasta dedicada que qualquer pessoa pode usar.
  • Fluxos de trabalho repetíveis:garanta que tarefas complexas com várias etapas sejam realizadas de forma consistente fornecendo instruções padrão.
  • Pacotes de recursos:inclua scripts, modelos ou dados de exemplo junto com suas instruções para que o agente tenha tudo o que precisa em um só lugar.
  • Uso eficiente da janela de contexto:para economizar tokens de contexto, apenas os metadados da skill (nome e descrição) são carregados inicialmente. O arquivo SKILL.md completo só é carregado após a ativação. Os arquivos de suporte nos diretórios references/, scripts/ ou assets/ só são carregados no contexto quando o agente precisa deles.

Criar suas próprias habilidades

O agente procura habilidades nos diretórios .skills/ ou .agent/skills/ localizados na raiz do projeto. Para criar uma skill personalizada, siga estas etapas:

  1. Crie um diretório para sua skill (por exemplo, my-new-skill/).
  2. Crie um arquivo SKILL.md (sensível a maiúsculas e minúsculas) no novo diretório.

As habilidades precisam seguir estas regras:

  • Um diretório por habilidade:cada habilidade precisa ter um diretório exclusivo que inclua um arquivo SKILL.md e recursos adicionais.
  • Aninhamento:todas as habilidades precisam estar no diretório .skills/ ou .agent/skills/ na raiz do projeto. No entanto, é possível usar subdiretórios para melhor organização (por exemplo, skills/ui-flows/<skill name>/SKILL.md ou skills/testing/<skill name>/SKILL.md).
  • Escopo:no momento, apenas habilidades localizadas na base de código do projeto são compatíveis.

O arquivo SKILL.md usa um bloco YAML para metadados e Markdown padrão para as instruções.

  • name: um identificador exclusivo da habilidade. Ele precisa corresponder ao nome do diretório.
  • description: uma explicação clara do que a habilidade faz e quando o agente deve usá-la.
  • Corpo:o corpo em Markdown abaixo do bloco YAML contém as instruções que orientam o comportamento do agente quando a skill está ativa.
---
name: skill-name
description: A description of what this skill does and when to use it.
metadata:
  author: example-org
  version: "1.0"
---

Skill content

Diretrizes de formato

  • Nome:máximo de 64 caracteres (somente letras minúsculas, números e hifens).
  • Descrição:no máximo 1.024 caracteres.
  • Conteúdo do corpo:tente usar de 10 mil a 20 mil caracteres (~2.500 a 5.000 tokens). Se as instruções excederem esse limite, mova a documentação detalhada para um arquivo de recursos, conforme descrito em Diretórios de habilidades opcionais.

Diretórios de habilidades opcionais

Para manter o arquivo SKILL.md conciso e modular, inclua recursos adicionais nos seguintes diretórios opcionais na pasta da sua skill:

  • scripts/: contém código executável (por exemplo, Python ou Bash) que o agente pode executar.
  • references/: contém documentação técnica detalhada, referências de API ou guias específicos do domínio.
  • assets/: contém recursos estáticos, como modelos de documentos, diagramas de interface do usuário ou esquemas JSON.

Ao se referir a esses arquivos nas instruções SKILL.md, use caminhos relativos da raiz da skill. Por exemplo: Run the script at scripts/cleanup.py.