Como planejar um projeto com o GitHub Copilot

Gerencie seu projeto com o GitHub Issues usando Copilot. Neste tutorial, você usará recursos de criação de issues do Copilot para transformar sua ideia de produto em épicos, recursos e tarefas. Épicos representam grandes corpos de trabalho, enquanto recursos e tarefas dividem o trabalho em partes menores e acionáveis. Ao final, você terá uma lista de pendências estruturada pronta para compartilhar com sua equipe.

Visão geral do projeto

É importante definir o que você deseja que seu produto faça. Na fase de planejamento do SDLC (ciclo de vida de desenvolvimento de software), você pode transformar ideias em tarefas acionáveis, separando seu projeto em épicos, recursos e partes menores de trabalho. Isso ajuda você a organizar suas ideias, definir prioridades e preparar sua equipe para o desenvolvimento.

Quando você usa Copilot, conduz esse processo. Copilot pode sugerir uma estrutura e preencher os detalhes, mas os melhores resultados vêm quando você tem uma noção de como deseja que o trabalho seja organizado. O Copilot funciona com sua entrada para ajudar você a refinar, expandir e documentar seu plano.

Nesse cenário, você planejará um novo site de compras que permitirá aos usuários:

• Procurar um catálogo de produtos com categorias e pesquisa
• Adicionar itens a um carrinho de compras
• Concluir check-outs seguros

Sua meta é usar o Copilot para transformar rapidamente essa visão em um plano de projeto estruturado, criando épicos e issues detalhados que capturam cada parte do seu site.

Configure o repositório

Configure um repositório que tenha GitHub Issues habilitados. Confira Criar um repositório.

Por padrão, os issues são habilitados para novos repositórios. Se você quiser usar um repositório existente, mas não vir a guia Issues, siga estas etapas para habilitar os issues:

1. No repositório, selecione Configurações.
2. Em "Recursos", marque a caixa Issues.

Gerar issues de projeto

Com o repositório configurado, você pode usar o Copilot para transformar sua visão de projeto em um conjunto de issues acionáveis.

Comece no modo de exibição imersivo do Copilot

1. Na parte superior direita de qualquer página no GitHub, clique no botão ao lado da barra de pesquisa.

   A versão imersiva de página inteira do Copilot Chat é exibida.

2. Usando o painel de chat, anexe o repositório ao site de compras. Isso permite que o Copilot acesse o repositório e crie issues diretamente dentro dele.

Criar um issue de épico

1. Insira uma descrição detalhada do projeto como seu prompt. Por exemplo:
   I’m planning to create a shopping website in React and Node.js. The site should allow users to browse products by category, search for items, add products to a cart, and complete checkout. Please help me plan the project by creating issues and breaking it down into epics, features, and tasks.
2. Envie seu prompt. O Copilot gerará uma árvore de issues, normalmente com um épico na parte superior e sub-issues para cada recurso ou tarefa principal

Navegar na árvore de issues

1. Clique no épico para exibir seus detalhes no workbench. Navegue pelo workbench para explorar a árvore de issues.

2. Cada issue normalmente inclui um título e uma descrição. Metadados adicionais, como rótulos ou destinatários, podem ser editados diretamente no workbench.

3. Você pode expandir ou recolher sub-issue para se concentrar em partes específicas do projeto.

   A árvore de issues apresenta uma visão geral clara da estrutura do projeto, facilitando a navegação entre épicos, recursos e tarefas.

4. Nesta primeira iteração do rascunho, o Copilot pode gerar apenas issues de alto nível. Você pode refinar ainda mais esses issues, separando-os em tarefas ou recursos menores. Vamos refinar o issue "Recurso: esqueleto e navegação da interface do usuário".

   Solicitar a Copilot:
   Can you break down the issue "Feature: UI Skeleton and Navigation" into smaller tasks?

   Copilot gerará vários novos sub-issues, como:

   • Tarefa: Configurar a estrutura do projeto React e os arquivos iniciais
   • Tarefa: Criar páginas de espaço reservado para rotas principais
   • Tarefa: Implementar o componente da barra de navegação em todo o site
   • Tarefa: Integrar navegação com roteamento
   • Tarefa: Adicionar layout dinâmico básico

5. Repita esse processo para os issues de recursos restantes no épico.

Melhorar as descrições do issue

Depois de terminar de gerar a árvore de issues, você poderá notar que as descrições de issues do Copilot podem ser breves ou não claras. Para torná-los acionáveis, refine cada issue conforme necessário.

1. Comece com o issue recém-gerado, como "Tarefa: criar páginas de espaço reservado para rotas principais".

   Solicitar a Copilot:
   Can you improve the description for “Task: Create placeholder pages for main routes”? Please provide a detailed technical summary, list the main routes to be included, outline the steps for implementation, and specify what should be delivered for this task.

2. O Copilot gerará uma nova versão do issue de rascunho "Tarefa: criar páginas de espaço reservado para rotas principais".

   No canto superior esquerdo do issue, clique na lista suspensa de controle de versão e selecione Versão 2 para examinar as novas alterações.

3. Examine e decida se deseja manter a versão revisada do Copilot, editar mais ou solicitar novamente mais detalhes.

4. Repita esse processo para outros issues no épico, refinando descrições e detalhando tarefas conforme necessário.

5. Quando estiver satisfeito com as descrições do issue, clique em Criar tudo para criar os issues no repositório.

Desvincular issues

Se o Copilot gerar um subconjunto que não pertença à árvore de issues, você poderá desvinculá-lo da árvore de issues.

1. Na árvore de issues do workbench, clique em ao lado do subdomínio e clique em Desvincular subconjunto.
2. O issue será desvinculado de seu pai e não aparecerá mais sob esse épico na árvore.

Próximas etapas

Agora que você gerou e refinou seus issues de projeto, pode atribuí-los aos membros certos da equipe ou até mesmo a Copilot para obter assistência adicional. Para saber mais sobre como atribuir Copilot ou colaboradores a issues e como continuar planejando e implementando seu projeto com o , confira Como pedir para o GitHub Copilot criar uma pull request.

Leitura adicional

• Usando o GitHub Copilot para criar issues
• Como pilotar o agente de codificação do GitHub Copilot em sua organização
• Práticas recomendadas de uso do GitHub Copilot para trabalhar em tarefas
• Como acelerar o trabalho de desenvolvimento com o GitHub Copilot Spaces