> ## Documentation Index
> Fetch the complete documentation index at: https://docs.devinenterprise.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Personalizações do Devin Local

> Estenda o agente Devin Local no Devin Desktop com regras, habilidades, plugins, servidores MCP e hooks, e veja o que cada sessão carregou.

O Devin Local oferece várias maneiras de personalizar o funcionamento do agente nos seus projetos. Use esta tabela para escolher a opção mais adequada:

| Recurso | O que faz | Como é ativado | Quando usar |
| - | - | - | - |
| **[Regras](#rules)** | Dizem ao agente *como se comportar* (por exemplo, "use bun, não npm") | Sempre ativas ou pelo frontmatter `trigger` | Convenções de código, guias de estilo, restrições do projeto |
| **[Habilidades](#skills)** | Procedimentos multi-step empacotados com arquivos de suporte (scripts, templates) | Invocadas pelo modelo quando relevantes ou por você | Tarefas complexas em que o agente precisa de arquivos de referência |
| **[Plugins](#plugins)** | Pacotes instaláveis de habilidades, regras, hooks, servidores MCP e subagentes | Instalados uma vez e compartilhados entre projetos e equipes | Distribuição de um conjunto de personalizações |
| **[Servidores MCP](#mcp-servers)** | Fornecem ao agente ferramentas de serviços externos | Configurados por projeto ou por usuário | Rastreadores de problemas, ferramentas de design, APIs internas |
| **[Hooks](#hooks)** | Executam comandos de shell ou prompts em eventos do ciclo de vida do agente | Configurados por projeto ou por usuário | Imposição de políticas, registro de logs, formatadores, notificações |

Como o Devin Local compartilha a infraestrutura de agente com o [Devin CLI](https://cli.devin.ai), 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](https://docs.devinenterprise.com/pt-BR/onboard-devin/migrate-from-other-agents.md).

## 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 arquivo `AGENTS.md` na raiz do seu projeto. Ele usa Markdown simples, sem frontmatter:

```markdown theme={null}
# Regras do projeto

- Use TypeScript em todos os arquivos novos
- Siga os padrões existentes em src/components/
- Sempre execute `npm run lint` antes de fazer commit
- Use pnpm, e não npm ou yarn
```

`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:

```markdown theme={null}
---
trigger: glob
globs: "**/*.test.ts"
---

Todos os arquivos de teste devem usar blocos `describe`/`it` e usar mocks para as chamadas de API externas.
```

| Valor de `trigger:` | Quando a regra chega ao agente |
| - | - |
| `always_on` | Em todas as sessões |
| `glob` | Quando o agente trabalha com arquivos que correspondem a `globs` |
| `model_decision` | Quando o agente decide que a descrição da regra é relevante |
| `manual` | Somente quando você a invoca |

`.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](https://docs.devinenterprise.com/pt-BR/cli/extensibility/rules.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 o `name` 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 arquivo `SKILL.md` cujo frontmatter YAML defina o nome e a descrição da skill:

```markdown theme={null}
---
name: deploy-to-production
description: Guides the deployment process to production with safety checks
---

## Pre-deployment Checklist
1. Run all tests
2. Check for uncommitted changes
3. Verify environment variables

## Deployment Steps
Follow these steps to deploy safely...
```

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

Coloque os arquivos de suporte na pasta da skill, junto com o `SKILL.md`. Eles ficam disponíveis para o agente quando a skill é invocada:

```
.devin/skills/deploy-to-production/
├── SKILL.md
├── deployment-checklist.md
├── rollback-procedure.md
└── config-template.yaml
```

### 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

| Escopo | Local | Disponibilidade |
| - | - | - |
| Workspace | `.devin/skills/<name>/` (`.agents/skills/` e o legado `.windsurf/skills/` também são lidos) | Somente o workspace atual. Comitado com seu repositório. |
| Global | `~/.config/devin/skills/<name>/` (`~/.agents/skills/` também é lido) | Todos os espaços de trabalho na sua máquina. Não é comitado. |
| Plugin | Dentro de um [plugin](#plugins) instalado | Onde quer que o plugin esteja instalado. |

Consulte a [documentação de habilidades do Devin CLI](https://docs.devinenterprise.com/pt-BR/cli/extensibility/skills/overview.md) para saber mais sobre gatilhos de skill, permissões e habilidades de terceiros, e [Como criar habilidades](https://docs.devinenterprise.com/pt-BR/cli/extensibility/skills/creating-skills.md) 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](https://docs.devinenterprise.com/pt-BR/cli/extensibility/plugins/overview.md) para saber mais sobre o formato de plugin, os comandos `devin plugins` e a governança.

> [!WARNING]
>
> Aqui, **Plugins** se refere aos plugins do *agente* Devin. Eles não têm relação com os [Plugins do Windsurf](https://docs.devinenterprise.com/pt-BR/windsurf/plugins/getting-started.md), que levam o Devin ao JetBrains, ao VS Code e a outros editores, nem com as [extensões do editor](https://docs.devinenterprise.com/pt-BR/desktop/recommended-extensions.md) que você instala no Devin Desktop: ambos estendem a IDE, e não o agente.

## 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](https://modelcontextprotocol.io/) 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.

Os administradores do Enterprise gerenciam os registros nas configurações da equipe, em **MCP & ACP**. A aba **Registro MCP** tem um controle que, além da lista de permissões de MCP, permite servidores que correspondam a uma entrada do registro. Ela também tem uma configuração **Registry** (**Configure**) para as URLs dos registros. Quando há vários registros configurados, o Devin Desktop usa a união de todos eles. Registros personalizados devem seguir o [schema oficial de Registro MCP](https://modelcontextprotocol.io/).

### Configuração

Os servidores MCP são configurados em [arquivos de configuração](https://docs.devinenterprise.com/pt-BR/cli/extensibility/mcp/configuration.md) na sua máquina local. O local do arquivo depende do escopo:

| Escopo | Local | Compartilhado com a equipe? |
| - | - | - |
| Projeto | `.devin/mcp_config.json` | Sim (incluído no controle de versão) |
| Override local | `.devin/mcp_config.local.json` | Não (ignorado pelo Git) |
| Usuário | `~/.config/devin/mcp_config.json` | Não |

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](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/permissions.md#mcp-permissions) 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:

```json theme={null}
{
  "PreToolUse": [
    {
      "matcher": "exec",
      "hooks": [
        {
          "type": "command",
          "command": "./scripts/check-command.sh"
        }
      ]
    }
  ]
}
```

Os Hooks não são carregados nem executados enquanto um workspace estiver aberto no [Modo Restrito](https://docs.devinenterprise.com/pt-BR/desktop/devin-local/overview.md#restricted-mode).

Consulte [hooks](https://docs.devinenterprise.com/pt-BR/cli/extensibility/hooks/overview.md) para ver os eventos de hook, o formato de configuração, os códigos de saída e exemplos.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.