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.

Observação

As habilidades só têm suporte no modo Genie Code Agent.

Criar uma habilidade

As habilidades residem no /Users/{username}/.assistant/skills/ diretório. Cada habilidade deve ter sua própria pasta e um SKILL.md arquivo dentro dessa pasta.

Para criar uma nova habilidade:

1. Na pasta do workspace do usuário, crie uma nova pasta de habilidades. O caminho da pasta deve ser: /Users/{username}/.assistant/skills/.

   Após a criação, você pode acessar rapidamente essa pasta 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, se você estiver criando uma habilidade para fluxos de trabalho pessoais, sua estrutura de pastas poderá ser:

   /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, você pode ter uma habilidade de fluxo de trabalho pessoal que faz referência às práticas recomendadas de ETL, modelos de painel e scripts para instalação e implantação de pipeline. A pasta da sua habilidade pode incluir os seguintes arquivos:

   /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
            └── model-deploy.py     # Model deployment automation
   

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:

• 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.