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
@skills:add-docs para gerar a documentação de múltiplos endpoints em paralelo.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)

