Como o Devin Local compartilha a infraestrutura de agente com o Devin CLI, todas as personalizações usam o formato e a descoberta do Devin CLI, e uma personalização criada para um funciona no outro.
Para reutilizar as regras do projeto e os fluxos de trabalho de outro agente tanto no Desktop quanto na nuvem, comece pelo prompt de migração.
Customize
A página Customize na janela agentes tem as abas Plugins, Habilidades, MCPs, Hooks, Regras e Subagentes. Cada aba mostra o que o agente carregou, além do que seu repositório, sua organização e sua conta oferecem. Para abri-la, clique em Customize na barra lateral do agente.Regras
Regras são instruções persistentes que definem como o agente se comporta no seu projeto. Elas são injetadas no contexto do agente no início de cada sessão, o que garante um comportamento consistente em toda a sua equipe. Entre os usos mais comuns das regras estão padrões de código, diretrizes de arquitetura, bibliotecas preferenciais, convenções de testes e restrições específicas do projeto.AGENTS.md
A maneira mais simples de adicionar regras é criar um arquivoAGENTS.md na raiz do seu projeto. Ele usa Markdown simples, sem frontmatter:
AGENTS.md, AGENTS.local.md (para regras pessoais que você mantém fora do controle de versão) e AGENT.md são todos lidos como regras sempre ativas. O agente os lê na raiz do espaço de trabalho e em cada diretório entre a raiz do espaço de trabalho e o diretório em que está trabalhando. Assim, um AGENTS.md em um subdiretório fornece orientações específicas para aquele diretório.
Arquivos de regras
Para ter mais controle, coloque uma regra por arquivo em.devin/rules/*.md. Cada arquivo pode definir quando se aplica com o campo trigger no frontmatter:
.devin/global_rules.md é um único arquivo sempre ativo. Coloque os mesmos arquivos no seu diretório pessoal (~/.devin/rules/*.md, ~/.devin/global_rules.md) para aplicá-los a todos os projetos.
Os arquivos legados .windsurf/rules/*.md, .windsurf/global_rules.md e .windsurfrules são importados por padrão. Os arquivos de regras em .devin/rules/ e em .windsurf/rules/ são todos carregados; quando existem os dois arquivos global_rules.md, apenas .devin/global_rules.md é carregado. Consulte regras e AGENTS.md para ver a lista completa de arquivos, as configurações de importação e as regras de outras ferramentas.
Práticas recomendadas
- Mantenha as regras curtas e específicas. As regras fazem parte do contexto de toda sessão, portanto consomem tokens a cada mensagem.
- Prefira uma skill para tudo o que o agente só precisa ocasionalmente e use uma regra para indicar ao agente quais habilidades ele deve usar em cenários específicos.
- Formate as regras com marcadores, listas numeradas e títulos em Markdown. Esses formatos são mais fáceis de seguir do que um parágrafo longo.
- Evite regras genéricas como “escreva um bom código”.
Habilidades
As tarefas de engenharia mais difíceis costumam exigir mais do que bons prompts. Elas podem depender de scripts de referência, templates, checklists e outros arquivos de suporte. As habilidades permitem que você reúna tudo isso em pastas que o agente pode invocar. As habilidades usam exposição progressiva: por padrão, apenas oname e a description da skill são exibidos ao modelo. O conteúdo completo do SKILL.md e os arquivos de suporte só são carregados quando o agente decide invocar a skill ou quando você a invoca. Assim, sua janela de contexto continua enxuta, mesmo com muitas habilidades definidas.
Como criar uma skill
Crie um diretório com um arquivoSKILL.md cujo frontmatter YAML defina o nome e a descrição da skill:
- name: Identificador único da skill (letras minúsculas, números e hifens). É usado para invocá-la.
- description: Breve explicação exibida ao modelo para ajudá-lo a decidir quando invocar a skill. Seja específico sobre o que a skill faz e quando usá-la.
SKILL.md. Eles ficam disponíveis para o agente quando a skill é invocada:
Como invocar habilidades
Quando sua requisição corresponder à descrição de uma skill, o agente invoca essa skill automaticamente e segue as instruções dela. Você também pode invocar uma skill pelo nome com/skill-name para garantir que ela seja usada.
Escopos de skill
Consulte a documentação de habilidades do Devin CLI para saber mais sobre gatilhos de skill, permissões e habilidades de terceiros, e Como criar habilidades para orientações sobre como escrevê-las.
Plugins
Plugins são pacotes instaláveis que adicionam habilidades, regras, hooks, servidores MCP e subagentes ao agente. Instale um plugin a partir de um repositório do GitHub, de uma URL do git, de uma subpasta de um repositório ou de uma pasta local; as habilidades dele ficam disponíveis como comandos/<plugin>:<skill>. Consulte plugins para saber mais sobre o formato de plugin, os comandos devin plugins e a governança.
Servidores MCP
O MCP (Model Context Protocol) é um protocolo que permite ao agente usar ferramentas de serviços externos, como GitHub, bancos de dados e rastreadores de problemas. Consulte a documentação oficial do MCP para mais informações.Instalação de servidores MCP
Abra a página Customize na janela agentes e clique em MCPs. Escolha o escopo no seletor Install MCPs for, na parte superior — por exemplo, This computer.- This computer lista os servidores que seu agente local carrega para as pastas abertas na janela. Você pode ativar ou desativar um servidor, abrir o arquivo de configuração dele ou atualizar a lista.
- Available lista os servidores dos seus registros MCP. Clique em Install em um servidor para adicioná-lo.
Configuração
Os servidores MCP são configurados em arquivos de configuração na sua máquina local. O local do arquivo depende do escopo:
O Devin Local oferece suporte aos transportes
stdio, Streamable HTTP e SSE, além de OAuth para cada um deles.
Permissões
Por padrão, o agente pede aprovação antes de chamar qualquer ferramenta MCP. Consulte Permissões de MCP para saber como permitir uma ferramenta ou um servidor e como os administradores podem permitir integrações confiáveis por padrão.Reautenticação
Quando as credenciais OAuth armazenadas de um servidor expiram, o servidor passa a exibir o estado Needs authentication. Esse estado aparece na lista This computer, no cartão Available e na página de detalhes do servidor. Clique em Authenticate para limpar as credenciais armazenadas e executar novamente o fluxo de autorização no navegador.Hooks
Os hooks executam lógica personalizada em eventos do ciclo de vida do agente, por exemplo, antes de uma chamada de ferramenta. Cada hook é um comando de shell ou um prompt para um LLM. Use hooks para impor políticas, adicionar contexto, registrar ações, modificar permissões ou se integrar a sistemas externos. Os hooks são configurados em.devin/hooks.v1.json, no seu projeto ou no nível do usuário. Por exemplo, este hook executa um script antes de cada comando de shell e pode bloquear o comando:

