Competências

Uma competência é um procedimento nomeado e reutilizável que ensina ao Zero como a tua equipa faz um tipo específico de trabalho.

Da primeira vez que pedes ao Zero para fazer algo, escreves um prompt. Da segunda vez, talvez coles o mesmo prompt com pequenos ajustes. À terceira, estás a copiar um prompt longo de um documento do Notion a que alguém chamou a "biblioteca de prompts da equipa". Esse é o momento de o transformar numa competência.

O problema que as competências resolvem

Um chat pontual serve para uma tarefa pontual. Mas quase todas as equipas têm uma acumulação de trabalho que se repete — entradas diferentes, mesma forma:

Um cliente escreve → consulta o seu histórico → redige uma resposta no idioma dele → regista o ticket
Surge um relatório de erro → extrai os passos de reprodução → classifica a gravidade → abre um issue estruturado
Segunda-feira de manhã → extrai os números da semana passada → compara com a semana anterior → publica um resumo

Sem competências, cada uma destas é um prompt de 200 palavras que toda a gente tem de memorizar. Com competências, são um comando de barra: /triage-bug-report, /weekly-metrics, /customer-reply.

Cada competência é nomeada com uma / inicial. Um seletor visual de competências está no roteiro — por agora, crias uma competência, dizes ao teu agente que ela existe, e o agente usa-a a partir daí.

Quando criar uma competência

A regra honesta: se escreveste substancialmente o mesmo prompt mais do que duas vezes — ou consegues imaginar um colega a escrevê-lo — é uma competência.

Sinais concretos:

O trabalho tem um nome que a tua equipa já usa ("resumo matinal", "análise da concorrência")
O prompt menciona ferramentas, canais ou modelos específicos que não devem mudar a cada execução
O resultado tem uma forma fixa (um resumo, um rascunho, um issue aberto)
Várias pessoas da equipa precisam de o acionar
Queres que corra num agendamento

O que existe numa competência

Uma competência é um documento markdown curto com três secções:

Descrição. Um resumo de uma linha que diz ao Zero quando esta competência se aplica. O Zero faz a correspondência dos pedidos recebidos com as descrições, por isso a formulação importa — "triar um relatório de erro virado para o cliente e abri-lo no GitHub com gravidade" é melhor do que "fazer cenas de erros".
Corpo. O procedimento em si. Prosa simples serve; não precisas de pseudocódigo. Menciona as ferramentas que o Zero deve usar, a forma do resultado e quaisquer restrições. O corpo parece-se muito com o prompt de chat original que funcionou.
Conectores permitidos (opcional). Uma lista de restrição — se só quiseres que esta competência toque no Slack e no GitHub, indica-os. Por predefinição, a competência pode usar tudo o que o teu espaço de trabalho tem ligado.

É só isso. Sem grafo de nós, sem configuração YAML, sem secção de gatilhos.

Escrever uma competência a partir de um chat

O caminho mais rápido é escrever o prompt no chat primeiro, pô-lo a funcionar e depois promovê-lo. O Zero pode fazer isto por ti:

"Transforma a última conversa numa competência reutilizável chamada triage-bug-report. Faz a descrição concisa."

O Zero vai:

Reler a conversa
Extrair o procedimento
Propor uma descrição
Guardar a competência no teu espaço de trabalho
Dizer-te o nome canónico que podes usar mais tarde

Edita a competência guardada a partir da página Skills no teu espaço de trabalho se quiseres refinar a redação.

Como o Zero escolhe uma competência

Não tens de invocar uma competência pelo nome. O Zero carrega a competência automaticamente quando um pedido recebido corresponde à sua descrição. Por isso, se escreveste uma competência chamada customer-reply-draft com a descrição "redigir uma resposta a um email de cliente usando a nossa voz e docs", então reencaminhar um email de cliente — ou dizer "redige uma resposta a este cliente" — vai acionar essa competência sem que a nomeies.

Se quiseres forçar uma competência específica, menciona-a explicitamente: "Usa a competência customer-reply-draft neste email."

Competências integradas

Cada agente Zero vem com um conjunto de competências transversais incorporadas pela VM0 — abrangendo investigação e análise, finanças e contabilidade, jurídico e conformidade, produto, marketing, apoio ao cliente e comunicação de equipa. São procedimentos de domínio, não fluxos de trabalho de conectores: cada um ensina ao Zero como lidar com um tipo recorrente de trabalho.

Cada uma é um comando de barra que podes invocar diretamente. Uma amostra:

/deep-dive — investigação estruturada e desenho de soluções; reunir factos e depois explorar opções
/prd-writing — requisitos de produto com enquadramento estruturado do problema e critérios de aceitação
/copywriting — texto de marketing para vários canais (blogs, emails, redes sociais, páginas de destino)
/competitor-matrix — matrizes de comparação de funcionalidades, análises de posicionamento, análise de ganhos/perdas
/customer-reply — respostas empáticas e alinhadas com a marca, adaptadas ao canal e à urgência
/nda-screening — classificar NDAs recebidos como GREEN / YELLOW / RED e encaminhá-los
/status-updates — relatórios de progresso e atualizações para partes interessadas, adaptados a qualquer público

Partilhar competências pela equipa

As competências têm âmbito de espaço de trabalho, não são pessoais. Assim que guardas uma competência, todos os membros do espaço de trabalho a podem usar. Não há um passo de "publicação" separado.

Isto importa: significa que a primeira pessoa a escrever uma competência útil dá essa capacidade a toda a equipa. Uma equipa de cinco com dez competências bem nomeadas move-se significativamente mais depressa do que uma equipa que trata cada tarefa individualmente.

Padrões comuns

Algumas formas que aparecem repetidamente:

O formulário de admissão. Uma competência que recebe uma peça de entrada (um email, um relatório de erro, um tópico) e produz um artefacto estruturado (um issue, um rascunho, uma linha).
O resumo de cadência. Uma competência emparelhada com um agendamento que corre diária ou semanalmente e publica num sítio visível.
O assistente a meio da conversa. Uma competência acionada por @Zero num canal que faz uma subtarefa focada (procurar, resumir, classificar).
O compositor. Uma competência que produz um pacote multiformato — rascunho de blog + publicações sociais + cartões — numa só execução.

Armadilhas a evitar

Competências demasiado restritas. Se uma competência só encaixa numa entrada muito específica, é frágil. Aponta à forma do trabalho, não aos detalhes da entrada.
Competências demasiado vagas. "Ajudar com marketing" é tão amplo que o Zero não vai saber quando a aplicar. Sê específico na descrição.
Competências que fixam credenciais no código. Não coles chaves de API nos corpos das competências. Usa conectores personalizados em vez disso.
Competências que escondem a forma do resultado. Indica explicitamente como deve ser o artefacto — "uma lista numerada de três itens" ou "uma resposta em rascunho com menos de 150 palavras".

O que se segue

Coloca uma competência num agendamento para que corra sem que escrevas.
Restringe que conectores uma competência pode tocar através de permissões.
Consulta Exemplos de fluxos de trabalho para competências escritas de ponta a ponta.