Estender o Genie Code com habilidades de agente

Crie habilidades para estender o Genie Code no modo agent com funcionalidades especializadas para suas tarefas específicas de domínio. Esta página explica como criar e otimizar habilidades.

O que são habilidades?

Crie habilidades para estender o Genie Code com funcionalidades especializadas. As habilidades seguem o padrão aberto de Habilidades do Agente. Conhecimento e fluxos de trabalho específicos do domínio do pacote de competências que o Genie Code pode carregar quando pertinente para executar tarefas específicas. As habilidades podem incluir diretrizes, práticas recomendadas, código reutilizável e scripts executáveis.

As habilidades devem ser adaptadas para tarefas específicas do domínio. Com as habilidades, você pode fornecer um contexto maior (como scripts, exemplos e outros recursos) para uma tarefa do que você pode com instruções. Ao contrário das instruções personalizadas, que são aplicadas globalmente, as habilidades são carregadas automaticamente e somente no contexto relevante. No modo agente, o Genie Code carrega automaticamente as habilidades quando relevante, com base em sua solicitação e na descrição da habilidade. Você também pode invocar habilidades @ manualmente mencionando-as. Isso mantém uma janela de contexto eficiente e reduz a necessidade de fornecer o mesmo contexto em vários chats.

Há dois tipos de habilidades:

• Habilidades de Espaço de Trabalho: disponíveis para todos no Espaço de Trabalho. Os administradores do espaço de trabalho podem criar funcionalidades do espaço de trabalho e conceder a outras pessoas acesso à pasta de funcionalidades para adicionar mais. Use habilidades de espaço de trabalho para fluxos de trabalho que são amplamente úteis em toda a sua equipe, como fluxos de trabalho de aprendizado de máquina ou processos específicos do domínio.
• Habilidades do usuário: disponível somente para você. Use as habilidades do usuário para fluxos de trabalho pessoais que não são relevantes para outros membros do workspace.

Criar uma habilidade

As habilidades estão em um .assistant/skills/ diretório. Cada habilidade deve ter sua própria pasta e um SKILL.md arquivo dentro dessa pasta. O local depende do tipo de habilidade:

• Habilidades de espaço de trabalho: Workspace/.assistant/skills/
• Habilidades do usuário: /Users/{username}/.assistant/skills/

Para criar uma nova habilidade:

1. Crie uma nova pasta de habilidades no caminho apropriado para o seu tipo de habilidade.

   Após a criação, você pode acessar rapidamente sua pasta de habilidades no painel Genie Code. Clique no Configurações e clique Abra a pasta de habilidades.

2. Crie uma pasta dedicada para sua habilidade dentro da pasta de habilidades. Cada habilidade deve ter sua própria pasta. Por exemplo:

   Workspace/.assistant/skills/
   └── ml-workflows/
       └── SKILL.md
   
   /Users/{username}/.assistant/skills/
   └── personal-workflows/
       └── SKILL.md
   

3. Dentro da pasta de habilidades, crie um SKILL.md arquivo. Esse arquivo é necessário e define a habilidade. As habilidades seguem as especificações das Habilidades do Agente.

4. Adicione o frontmatter necessário para sua habilidade:

   ---
   name: skill-name
   description: A description of what this skill does and when to use it.
   ---
   

5. Adicione as instruções de habilidades no formato Markdown após o frontmatter. É recomendável incluir as seguintes seções:

   • Instruções passo a passo: Orientações processuais claras
   • Exemplos: exemplos de entradas e saídas esperadas
   • Casos extremos: variações e exceções comuns

6. (Opcional) Para habilidades mais complexas, você pode fornecer e referenciar recursos adicionais:

   • Scripts que contêm código executável que o agente pode executar.
   • Arquivos que contêm documentação adicional para referência, como práticas recomendadas e modelos.

   Ao referenciar outros arquivos, use caminhos relativos da habilidade raiz.

   Por exemplo, uma habilidade de fluxo de trabalho de aprendizado de máquina em ambiente de trabalho e uma habilidade de fluxo de trabalho pessoal podem ter a seguinte estrutura:

   Workspace/.assistant/skills/
   ├── ml-workflows/
      ├── SKILL.md                # Workflow overview and best practices
      ├── training-patterns.md    # Standard ML training patterns
      └── scripts/
            └── model-deploy.py   # Model deployment automation
   
   /Users/{username}/.assistant/skills/
   ├── personal-workflows/
      ├── SKILL.md                # Workflow overview and best practices
      ├── etl-patterns.md         # Personal ETL best practices
      ├── dashboard-templates.md   # Reusable dashboard patterns
      └── scripts/
            └── pipeline-setup.sh   # Environment setup scripts
   

O Genie Code seleciona automaticamente suas habilidades na próxima vez que você usá-lo no modo agente. Você também @ pode mencionar habilidades para garantir que o Genie Code as utilize.

Práticas recomendadas

Siga estas diretrizes para escrever habilidades eficazes:

• Escolha o tipo de habilidade apropriado. Use as habilidades de espaço de trabalho para fluxos de trabalho que beneficiam muitos usuários, como pipelines de aprendizado de máquina compartilhados ou processos específicos do domínio. Use as habilidades do usuário para fluxos de trabalho pessoais que não são relevantes para outras pessoas.
• Mantenha o foco nas habilidades. As habilidades funcionam melhor quando se concentram em uma única tarefa ou fluxo de trabalho. O escopo estreito torna mais fácil para o Genie Code reconhecer quando uma habilidade se aplica.
• Use nomes e descrições claros. Um nome conciso e descritivo e um resumo ajudam o Genie Code a corresponder a habilidade certa à solicitação certa.
• Seja explícito e orientado a exemplos. Descreva os fluxos de trabalho passo a passo e inclua exemplos concretos ou padrões que o Genie Code pode reutilizar.
• Evite contexto desnecessário. Inclua apenas as informações necessárias para a tarefa. Detalhes extras podem tornar as habilidades mais difíceis de aplicar de forma confiável.
• Iterar ao longo do tempo. Trate as habilidades como fluxos de trabalho vivos. Pequenas atualizações com base no uso real podem melhorar significativamente os resultados.
• Separe as diretrizes da automação. Use markdown para explicar a intenção e as melhores práticas e scripts para ações repetíveis. Manter essas preocupações distintas torna as habilidades mais fáceis de manter e reutilizar.

Consulte também

• Dicas para melhorar as respostas do Genie Code: saiba como referenciar manualmente as habilidades no prompt de chat.
• Habilidades de agente para assistentes de codificação por IA: Descubra e instale habilidades de agente para assistentes de codificação por IA como Claude e GitHub Copilot.