Usando o GitHub Copilot para criar issues

Use o Copilot para gerar rapidamente issues estruturados e de alta qualidade baseados em imagens ou linguagem natural, sem preencher todos os campos manualmente.

Quem pode usar esse recurso?

Anyone with a Copilot license can use Copilot to create issues.
Try Copilot for free

Neste artigo

Observação

Esse recurso está em versão prévia pública e sujeitos a alterações.

Criar issues manualmente pode ser repetitivo e demorado. Com Copilot, você pode criar issues mais rapidamente gerando prompts em linguagem natural ou até carregando uma captura de tela. O Copilot preenche o título, o corpo, os rótulos, os atributos e muito mais, usando os formulários ou modelos de problema do repositório.

Você mantém o controle do processo. Você pode examinar e refinar o que o Copilot sugere antes de enviar o novo problema.

Criando um issue com o Copilot

Você pode criar issues na exibição imersiva do Copilot Chat.

  1. Vá para a exibição imersiva de Copilot Chat (https://github.com/copilot).

  2. Na caixa de prompt, descreva o problema que você deseja criar.

    Se você contribuir com problemas para vários repositórios, use o formato repo-owner/repo-name para especificar o repositório de destino para esse problema. Se você não especificar um repositório, o Copilot inferirá com base no repositório no qual você criou um issue pela última vez.

    Por exemplo:

    • Em OWNER/REPOSITORY, crie uma solicitação de recurso para adicionar correspondência difusa à pesquisa.

    • Registre um bug para um erro 500. Isso acontece consistentemente quando tento fazer logon no site.

    • Crie uma tarefa para alterar o plano de fundo do logotipo do aplicativo para vermelho e adicione o rótulo "precisa de revisão de design".

    Observação

    Você só pode usar o Copilot para criar issues em repositórios onde já tem permissão para criar issues. Esse recurso não altera o acesso nem ignora as permissões do repositório.

  3. Como alternativa, você pode usar um dos seguintes métodos para incluir uma imagem em seu prompt:

    • Copie uma imagem e cole-a na caixa de prompt na parte inferior da página.
    • Clique em na caixa de prompt e clique em Image. Navegue até o arquivo de imagem que deseja anexar, selecione-o e clique em Open.
    • Arraste e solte um arquivo de imagem do explorador de arquivos do sistema operacional para a caixa de prompt.

    Depois de colar ou carregar a imagem, você pode adicionar texto ao prompt, por exemplo: Create an issue because this error appears when trying to reset a password.

  4. O Copilot criará um problema que inclui:

    • Um título sugerido.

    • Detalhes das alterações necessárias.

      Se o repositório tiver formulários ou modelos de problema, o Copilot escolherá um formulário ou modelo apropriado com base no prompt. Se não houver formulários ou modelos, o Copilot criará um corpo de problema básico para os detalhes do problema.

      Se o Copilot usar um formulário de problema, ele dividirá as informações em seu prompt nos campos relevantes do formulário sem perder nenhum dado. O Copilot solicitará que você forneça contexto adicional se houver campos que não tenham informações suficientes para preencher.

    Com base no prompt, o Copilot também poderá sugerir metadados, como rótulos, destinatários e tipo de problema.

  5. Revise o rascunho. Você poderá:

    • Edite qualquer parte do issue manualmente.
    • Escolha um formulário ou modelo de problema diferente sem perder sua entrada. O Copilot reformata o conteúdo de acordo com o formulário ou modelo escolhido.
    • Peça ao Copilot para fazer alterações com um prompt de acompanhamento.

  6. Quando o issue parecer bom, clique em Create.

Criando vários issues de uma só vez

Se o prompt incluir várias tarefas ou bugs, o Copilot poderá elaborar mais de um issue por vez.

Por exemplo: em PROPRIETÁRIO/REPOSITÓRIO, crie 3 problemas: 1) DETALHES DE UMA TAREFA, 2) DETALHES DE OUTRA TAREFA, 3) DETALHES DE UMA TERCEIRA TAREFA

Cada rascunho é exibido separadamente e você pode revisá-los e editá-los individualmente. Para publicar os issues, clique em Create em cada que deseja enviar.

Como criar sub-issues

Você pode usar o Copilot para criar rascunhos de vários sub-issues.

Por exemplo:

In octo-org/octo-repo, plan a new user dashboard. Break it down into an epic, and create sub-issues for each main feature and task.

O Copilot gera uma árvore de issues de rascunho, com um issue pai no nível superior e sub-issues abaixo.

Você pode examinar a árvore de issues, expandir ou recolher sub-issues e editar os detalhes de cada issue.

Clique no issue pai para exibir seus detalhes no workbench. O issue pai exibe uma lista de subconjunto. Você pode clicar em cada um deles para exibir e editar seus detalhes no workbench. Em um subconjunto, use a lista suspensa "Pai" para navegar pela árvore de issues. Você também pode clicar em Examinar e criar na parte superior do workbench para ver a árvore de issues completa e navegar diretamente para qualquer issue.

O Copilot pode modificar a árvore, desvinculando issues ou anexando novos rascunhos.

Por exemplo, você pode:

  • Remova um subconjunto da árvore de issues:
    Remove sub-issue NAME_OF_ISSUE from the issue tree
  • Adicione um subconjunto adicional à árvore de issues: Add an additional sub-issue with ISSUE_DETAILS to the issue tree

Depois de terminar de editar os rascunhos e estar pronto para publicar os issues, clique em Examinar e criar e clique em Criar issue.

Como trabalhar com issues existentes

Você pode usar o Copilot para conectar novos issues a issues que já existem em seu repositório.

Por exemplo, você pode:

  • Adicione um subconjunto a um issue pai existente:
    Create a sub-issue for octo-org/octo-repo issue #456.
  • Adicione um issue pai a um issue existente: Create a parent issue for octo-org/octo-repo issue #456.
  • Adicione um issue pai a vários issues existentes: Create a parent issue for octo-org/octo-repo issues #456, #457, and #458.

O rascunho é exibido no workbench, no qual você pode revisá-lo e editá-lo. Para publicar o issue, clique em Examinar e criar e clique em Criar issues.

Atribuindo issues ao Copilot

Para atribuir um issue ao Copilot, você precisa ter o Agente de codificação do Copilot habilitado. Confira Sobre o agente de codificação do GitHub Copilot para empresas e negócios.

Você pode atribuir o issue durante a criação de uma das duas maneiras:

  • Linguagem natural: solicita a Copilot algo como Assign this issue to Copilot.
  • Manualmente: selecione "Copilot" na lista de destinatários.

Após o issue ser atribuído e criado, o Copilot começará a trabalhar nele automaticamente. Você verá uma reação com emoji 👀 no issue para indicar que o Copilot está trabalhando nele.

Leitura adicional