{"meta":{"title":"Criando um plug-in para GitHub Copilot CLI","intro":"Crie um plug-in para compartilhar personalizações em um pacote fácil de instalar.","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/plugins-creating","title":"Plug-ins: Criar um plug-in"}],"documentType":"article"},"body":"# Criando um plug-in para GitHub Copilot CLI\n\nCrie um plug-in para compartilhar personalizações em um pacote fácil de instalar.\n\n## Introdução\n\nPlug-ins são pacotes que estendem a funcionalidade de Copilot CLI. Confira [Sobre plug-ins GitHub Copilot](/pt/copilot/concepts/agents/about-plugins).\n\n> \\[!NOTE]\n> Você pode encontrar ajuda para usar plug-ins entrando `copilot plugin [SUBCOMMAND] --help` no terminal.\n\n## Estrutura de plug-in\n\nUm plug-in consiste em um diretório com uma estrutura específica. No mínimo, ele deve conter um `plugin.json` arquivo de manifesto na raiz do diretório. Ele também pode conter qualquer combinação de agentes, habilidades, ganchos e configurações de servidor MCP.\n\n### Estrutura de plug-in de exemplo\n\n```text\nmy-plugin/\n├── plugin.json           # Required manifest\n├── agents/               # Custom agents (optional)\n│   └── helper.agent.md\n├── skills/               # Skills (optional)\n│   └── deploy/\n│       └── SKILL.md\n├── hooks.json            # Hook configuration (optional)\n└── .mcp.json             # MCP server config (optional)\n```\n\n## Criando um plug-in\n\n1. Crie um diretório para o plug-in.\n\n2. Adicione um `plugin.json` arquivo de manifesto à raiz do diretório.\n\n**Arquivo de exemplo `plugin.json`**\n\n```json copy\n{\n  \"name\": \"my-dev-tools\",\n  \"description\": \"React development utilities\",\n  \"version\": \"1.2.0\",\n  \"author\": {\n    \"name\": \"Jane Doe\",\n    \"email\": \"jane@example.com\"\n  },\n  \"license\": \"MIT\",\n  \"keywords\": [\"react\", \"frontend\"],\n  \"agents\": \"agents/\",\n  \"skills\": [\"skills/\", \"extra-skills/\"],\n  \"hooks\": \"hooks.json\",\n  \"mcpServers\": \".mcp.json\"\n}\n```\n\nPara obter detalhes do conjunto completo de campos que você pode incluir neste arquivo, consulte [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference#pluginjson).\n\n1. Adicione alguns componentes ao plug-in criando os arquivos e diretórios apropriados para agentes, habilidades, ganchos e configurações de servidor MCP.\n\n   Por exemplo:\n\n   1. Adicione um agente criando um `NAME.agent.md` arquivo em um `agents` subdiretório.\n\n      ```markdown copy\n      ---\n      name: my-agent\n      description: Helps with specific tasks\n      tools: [\"bash\", \"edit\", \"view\"]\n      ---\n\n      You are a specialized assistant that...\n      ```\n\n   2. Adicione uma habilidade criando um `skills/NAME` subdiretório do diretório do plug-in, onde `NAME` está o nome da sua habilidade. Em seguida, dentro desse subdiretório, crie um `SKILL.md` arquivo que defina a habilidade.\n\n      Por exemplo, para desenvolver uma skill chamada \"deploy\", crie o seguinte `skills/deploy/SKILL.md`:\n\n      ```markdown copy\n      ---\n      name: deploy\n      description: Deploy the current project to...\n      ---\n\n      Instructions for the skill...\n      ```\n\n2. Instale o plug-in localmente, para que você possa testá-lo à medida que o desenvolve.\n\n   Por exemplo, onde `./my-plugin` está o caminho para o diretório do plug-in, insira:\n\n   ```shell copy\n   copilot plugin install ./my-plugin\n   ```\n\n3. Verifique se o plug-in foi carregado com êxito exibindo sua lista de plug-ins instalados:\n\n   ```shell copy\n   copilot plugin list\n   ```\n\n   Ou você pode iniciar uma nova sessão interativa e inserir:\n\n   ```copilot copy\n   /plugin list\n   ```\n\n4. Verifique se os agentes, as habilidades, os ganchos e as configurações do servidor MCP definidos são carregados corretamente.\n\n   Por exemplo, em uma sessão interativa, para verificar se os agentes personalizados definidos no plug-in foram carregados, insira:\n\n   ```copilot copy\n   /agent\n   ```\n\n   Para verificar se as habilidades definidas no plug-in foram carregadas, insira:\n\n   ```copilot copy\n   /skills list\n   ```\n\n5. Use a funcionalidade fornecida pelos componentes do plug-in para verificar se cada componente funciona conforme o esperado.\n\n6. Faça iterações no desenvolvimento do plug-in, conforme necessário.\n\n   > \\[!IMPORTANT]\n   > Quando você instala um plug-in, seus componentes são armazenados em cache e a CLI lê do cache para sessões subsequentes. Para pegar as alterações feitas em um plug-in local, instale-o novamente:\n   >\n   > ```shell copy\n   > copilot plugin install ./my-plugin\n   > ```\n\n7. Depois de concluir o teste, você poderá desinstalar a versão local do plug-in inserindo:\n\n   ```shell copy\n   copilot plugin uninstall NAME\n   ```\n\n   > \\[!NOTE]\n   > Para desinstalar um plug-in, use o nome do plug-in conforme especificado no `name` campo do arquivo de manifesto do plug-in `plugin.json` , não o caminho para o diretório do plug-in.\n\n## Distribuindo seu plug-in\n\nPara distribuir o plug-in, você pode adicioná-lo a um marketplace. Confira [Criando um marketplace de plugin para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-marketplace).\n\n## Leitura adicional\n\n* [Localizando e instalando plug-ins para GitHub Copilot CLI](/pt/copilot/how-tos/copilot-cli/customize-copilot/plugins-finding-installing)\n* [referência de plugin da CLI GitHub Copilot](/pt/copilot/reference/copilot-cli-reference/cli-plugin-reference)"}