{"meta":{"title":"Adicionando instruções personalizadas para GitHub Copilot CLI","intro":"Dê Copilot contexto adicional sobre como entender seu projeto e como criar, testar e validar suas alterações.","product":"GitHub Copilot","breadcrumbs":[{"href":"/pt/copilot","title":"GitHub Copilot"},{"href":"/pt/copilot/how-tos","title":"Instruções"},{"href":"/pt/copilot/how-tos/copilot-cli","title":"Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot","title":"Personalizar Copilot CLI"},{"href":"/pt/copilot/how-tos/copilot-cli/customize-copilot/add-custom-instructions","title":"Adicionar instruções personalizadas"}],"documentType":"article"},"body":"# Adicionando instruções personalizadas para GitHub Copilot CLI\n\nDê Copilot contexto adicional sobre como entender seu projeto e como criar, testar e validar suas alterações.\n\nGitHub Copilot pode fornecer respostas adaptadas às suas preferências pessoais, à maneira como sua equipe funciona, às ferramentas que você usa ou às especificidades do seu projeto, se você fornecer contexto suficiente para isso. Em vez de adicionar repetidamente esse detalhe contextual aos seus prompts, você pode criar instruções personalizadas que adicionam automaticamente essas informações para você. As informações adicionais não são exibidas, mas estão disponíveis para Copilot para permitir que gere respostas de maior qualidade.\n\n## Tipos de instruções personalizadas\n\nGitHub Copilot CLI oferece suporte a instruções provenientes dos seguintes locais.\n\nSalvo indicação em contrário na tabela abaixo, Copilot CLI descobre arquivos de instruções do repositório e do agente nos **locais padrão**: a raiz do repositório, o diretório de trabalho atual, os diretórios intermediários entre eles e quaisquer diretórios aninhados no caminho de um arquivo no qual ele está trabalhando. Os arquivos de instrução modular (aqueles correspondentes `*.instructions.md`) são específicos do caminho— um arquivo com um `applyTo` valor se aplica somente a arquivos correspondentes.\n\n| Localidade                                                | Escopo e comportamento                                                                                                                                               |\n| --------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| `$HOME/.copilot/copilot-instructions.md`                  | Instruções em nível de usuário que se aplicam a todos os repositórios.                                                                                               |\n| `$HOME/.copilot/instructions/**/*.instructions.md`        | Instruções modulares em nível de usuário.                                                                                                                            |\n| `.github/copilot-instructions.md`                         | Instruções para todo o repositório, descobertas nos locais padrão.                                                                                                   |\n| `.github/instructions/**/*.instructions.md`               | Instruções de repositório modular, descobertas nos locais padrão, mas não em diretórios intermediários.                                                              |\n| `AGENTS.md`                                               | Instruções do agente encontradas nos locais padrão. Para obter mais informações, consulte o [repositório agentsmd/agents.md](https://github.com/agentsmd/agents.md). |\n| `CLAUDE.md`                                               | Instruções do agente encontradas nos locais padrão.                                                                                                                  |\n| Copilot CLI também usa `.claude/CLAUDE.md`.               |                                                                                                                                                                      |\n| `GEMINI.md`                                               | Instruções do agente encontradas nos locais padrão.                                                                                                                  |\n| Diretórios listados em `COPILOT_CUSTOM_INSTRUCTIONS_DIRS` | Arquivos adicionais `AGENTS.md` e `*.instructions.md`. Separe vários diretórios com vírgulas.                                                                        |\n\nSe você definir a variável de ambiente `COPILOT_HOME`, Copilot CLI usará esse diretório em vez de `$HOME/.copilot` para ambos os locais de instruções no nível do usuário.\n\nUse o `/instructions` comando para exibir os arquivos de instrução descobertos para a sessão atual e habilitar ou desabilitar arquivos individuais.\n\n## Como vários arquivos de instrução interagem\n\nQuando existem vários arquivos de instrução de nível de usuário e repositório aplicáveis, Copilot CLI combina suas instruções. Ele remove cópias duplicadas de instruções idênticas de nível `copilot-instructions.md`de usuário, repositório e agente, mas não define uma ordem de precedência geral entre esses arquivos. Evite instruções conflitantes.\n\nAs instruções específicas de caminho são incluídas somente quando o valor de `applyTo` corresponde a um arquivo com o qual Copilot CLI está trabalhando. Um arquivo de instrução que você desabilitar usando `/instructions` não está incluído.\n\n## Como criar instruções personalizadas em todo o repositório\n\n1. Na raiz do repositório, crie um arquivo chamado `.github/copilot-instructions.md`.\n\n   Crie o diretório `.github` se ele ainda não existir.\n\n2. Adicione instruções em linguagem natural ao arquivo, no formato Markdown.\n\n   O espaço em branco entre as instruções é ignorado, de modo que as instruções podem ser escritas como um só parágrafo, cada uma em uma nova linha ou separadas por linhas em branco para facilitar a leitura.\n\n   Para obter ajuda sobre como escrever instruções personalizadas eficazes, consulte [Sobre a personalização das respostas do GitHub Copilot](/pt/copilot/concepts/prompting/response-customization#writing-effective-custom-instructions).\n\n### Referenciando outros arquivos\n\nEm `.github/copilot-instructions.md`, `AGENTS.md`ou `CLAUDE.md`, use `@` seguido por um caminho relativo para incluir outro arquivo.\nCopilot CLI lê o arquivo referenciado imediatamente e dá suporte a referências em arquivos referenciados.\n\nOs arquivos referenciados devem permanecer no repositório ou no diretório de instruções personalizadas para obter instruções locais. Caminhos absolutos e caminhos que começam com `~/` não são carregados. As referências de arquivo não são expandidas nos arquivos `GEMINI.md` ou `*.instructions.md`.\n\n## Criar instruções personalizadas específicas para o caminho\n\n1. Crie o diretório `.github/instructions` se ele ainda não existir.\n\n2. Opcionalmente, crie subdiretórios de `.github/instructions` para organizar seus arquivos de instrução.\n\n3. Crie um ou mais arquivos `NAME.instructions.md`, em que `NAME` indica a finalidade das instruções. O nome do arquivo deve terminar com `.instructions.md`.\n\n4. No início do arquivo, crie um bloco frontmatter contendo a palavra-chave `applyTo`. Use a sintaxe glob para especificar a quais arquivos ou diretórios as instruções se aplicam.\n\n   Por exemplo:\n\n   ```markdown\n   ---\n   applyTo: \"app/models/**/*.rb\"\n   ---\n   ```\n\n   Você pode especificar vários padrões separando-os com vírgulas. Por exemplo, para aplicar as instruções a todos os arquivos TypeScript no repositório, você pode usar o seguinte bloco frontmatter:\n\n   ```markdown\n   ---\n   applyTo: \"**/*.ts,**/*.tsx\"\n   ---\n   ```\n\n   Exemplos do Glob:\n\n   * `*` – corresponderá a todos os arquivos no diretório atual.\n   * `**` ou `**/*` – todos corresponderão a todos os arquivos em todos os diretórios.\n   * `*.py` – corresponderá a todos os `.py` arquivos no diretório atual.\n   * `**/*.py` – corresponderá recursivamente a todos os `.py` arquivos em todos os diretórios.\n   * `src/*.py` – corresponderá a todos os `.py` arquivos no `src` diretório. Por exemplo, `src/foo.py` mas `src/bar.py`*não*`src/foo/bar.py`.\n   * `src/**/*.py` – corresponderá recursivamente a todos os `.py` arquivos no `src` diretório. Por exemplo, `src/foo.py`, `src/foo/bar.py` e `src/foo/bar/baz.py`.\n   * `**/subdir/**/*.py` – fará a correspondência recursiva de todos os arquivos `.py` em qualquer diretório `subdir` em qualquer profundidade. Por exemplo, `subdir/foo.py`, `subdir/nested/bar.py`, `parent/subdir/baz.py`e `deep/parent/subdir/nested/qux.py`, mas *não*`foo.py` em um caminho que não contém um `subdir` diretório.\n\n5. Opcionalmente, para impedir que o arquivo seja usado por Copilot cloud agent ou Copilot code review, adicione a palavra-chave `excludeAgent` ao bloco de frontmatter. Use `\"code-review\"` ou `\"cloud-agent\"`.\n\n   Por exemplo, o arquivo a seguir será lido apenas por Copilot cloud agent.\n\n   ```markdown\n   ---\n   applyTo: \"**\"\n   excludeAgent: \"code-review\"\n   ---\n   ```\n\n   Se a palavra-chave `excludeAgent` não estiver incluída no bloco front-matter, tanto o Copilot code review quanto o Copilot cloud agent usarão suas instruções.\n\n6. Adicione suas instruções personalizadas em linguagem natural usando o formato Markdown. O espaço em branco entre as instruções é ignorado, de modo que as instruções podem ser escritas como um só parágrafo, cada uma em uma nova linha ou separadas por linhas em branco para facilitar a leitura.\n\n## Instruções personalizadas em uso\n\nAs alterações feitas nos arquivos de instruções personalizadas não estão disponíveis imediatamente para uso em sessões da CLI ativa. Para aplicar suas alterações, saia da sessão atual e, em seguida, retome-a (por exemplo, execute `copilot --continue`) ou inicie uma nova sessão (por exemplo, use `/new` de dentro de uma sessão interativa).\n\n## Leitura adicional\n\n* [Suporte para diferentes tipos de instruções personalizadas](/pt/copilot/reference/custom-instructions-support)\n* [Instruções personalizadas](/pt/copilot/tutorials/customization-library/custom-instructions) — uma coleção de exemplos curada\n* [Usando instruções personalizadas para desbloquear o poder da revisão de código Copilot](/pt/copilot/tutorials/customize-code-review)"}