Skip to main content
Não quer configurar tudo isso manualmente? Cole o link desta página em uma sessão do Devin e peça que ele faça toda a configuração para você.
1

Crie uma skill de documentação

Comece criando uma skill para a tarefa que você quer padronizar. Neste exemplo, vamos criar uma skill que gera documentação de API sempre que um membro da equipe adiciona um rótulo a um ticket.Acesse Customize > Skills e clique em + (New skill). Dê a ela o nome add-docs.Escreva instruções passo a passo específicas. Cite caminhos de arquivo e convenções reais para que o Devin siga os padrões da sua equipe:Quanto mais específica for a skill, melhor será o resultado. Cite os templates de documentação, os guias de estilo e as ferramentas que sua equipe realmente usa. Para saber mais, consulte Como escrever uma boa skill.
2

Sincronizar a skill com o Linear

Conecte sua integração Linear, caso ainda não tenha feito isso: acesse Settings > Connections > Linear e clique em Connect. Selecione as equipes às quais o Devin deve ter acesso.Depois de conectar, role até Skills e clique em Add skill. Selecione add-docs no menu suspenso. Isso cria o rótulo da skill no Linear, no grupo de rótulos Devin Skills; a lista de Skills mostra o rótulo a ser usado (@skills:add-docs quando nenhuma outra skill sincronizada tiver esse nome), com um botão para copiá-lo.A partir de agora, sempre que alguém adicionar esse rótulo a um ticket, o Devin iniciará uma sessão usando sua skill.
Para que os rótulos de skills sejam sincronizados automaticamente com o Linear, seu workspace do Linear precisa ter a opção Manage workspace labels definida como All members (disponível em Settings > Security no Linear). Se essa opção não estiver ativada, você precisará criar os rótulos manualmente no Linear.
3

Aplicar rótulos a tickets e gerar documentação

Quando um membro da equipe adiciona o rótulo @skills:add-docs a um ticket como este:
ENG-215: Add POST /api/v2/webhooks endpoint — accepts a URL and event types, validates the URL is reachable, stores the subscription, and returns the webhook ID.
O Devin inicia automaticamente uma sessão e segue sua skill de documentação:
  • Lê o ticket — extrai a descrição do endpoint, os parâmetros e os PRs vinculados
  • Encontra o código-fonte — localiza o handler da rota, o schema de validação da requisição e os tipos de resposta
  • Gera a documentação — cria uma nova página em docs/api/ seguindo o formato que você já usa
  • Abre um PR — com a nova página de documentação e a barra lateral atualizada
Isso também funciona bem para operações em lote: selecione vários tickets com Cmd+A, clique com o botão direito e adicione o rótulo @skills:add-docs para gerar a documentação de múltiplos endpoints em paralelo.
Com a integração Linear instalada, o Devin tem acesso nativo às ferramentas do Linear, então sua skill pode instruir o Devin a atualizar os rótulos ou o status do ticket de acordo com o resultado. Como rótulos podem acionar outras automações, você pode encadear fluxos de trabalho — p. ex., depois que a documentação for gerada, um rótulo Docs Ready pode notificar o redator técnico para fazer a revisão.
4

Crie mais habilidades para sua equipe

O mesmo padrão funciona para qualquer tarefa recorrente. Crie uma skill, sincronize-a como um rótulo e sua equipe poderá acioná-la a partir de qualquer ticket. Veja algumas ideias:
  • @skills:write-tests — Adicionar cobertura de testes para a funcionalidade descrita em um ticket
  • @skills:refactor — Refatorar código seguindo as convenções da sua equipe
  • @skills:security-audit — Revisar o código em busca de vulnerabilidades de segurança e abrir um PR com as correções
  • @skills:migrate — Executar uma migração padronizada (atualização de dependências, nova versão de API)
Você também pode configurar automações para que o Devin comece a trabalhar sem que ninguém precise aplicar um rótulo. Acesse Configurações > Conexões > Linear, role até Automações, clique em Adicionar automação e configure uma automação que seja disparada quando os tickets mudarem para um status ou rótulo específico.