Planejando um projeto com GitHub Copilot

Gerencie seu projeto com GitHub Issues usando Copilot. Neste tutorial, você usará Copilotos recursos de criação de problemas agente 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ê quer que seu produto faça. Na fase de planejamento do ciclo de vida de desenvolvimento de software (SDLC), você transforma ideias em tarefas acionáveis, dividindo seu projeto em épicos, funcionalidades e partes menores de trabalho. Isso ajuda você a organizar suas ideias, definir prioridades e preparar sua equipe para o desenvolvimento.

Ao usar Copilot, você conduz esse processo. Copilot pode sugerir uma estrutura e preencher detalhes, mas os melhores resultados vêm quando você tem uma noção de como deseja que o trabalho seja organizado. Copilot funciona com sua entrada para ajudá-lo 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

Seu objetivo é usar Copilot para transformar rapidamente essa visão em um plano de projeto estruturado, criando épicos e itens detalhados que abrangem cada parte do seu site.

Configure o repositório

Configure um repositório com GitHub Issues habilitado. 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 questões do projeto

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

Inicie em Copilot em GitHub

1. Navegue até https://github.com/copilot.
2. Usando o painel de chat, anexe o repositório ao site de compras. Isso permite Copilot acessar o repositório e criar problemas diretamente dentro dele.

Criar um issue de épico

1. Insira uma descrição detalhada do projeto como seu comando. 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. Copilot gerará uma árvore de questões, normalmente com um item épico na parte superior e subquestões 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, Copilot pode gerar apenas problemas 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".

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

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

   • Tarefa: configurar a estrutura do React project 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 problemas, você pode notar que as descrições de problema de Copilot podem ser breves ou pouco 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".

   Prompt Copilot com: 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. Please add any relevant code snippets.

2.        Copilot gerará uma nova versão do rascunho do item "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. Revise e decida se deseja manter a versão revisada de Copilot, editar mais ou pedir mais detalhes novamente. Copilot pode adicionar snippets de código ao rascunho para melhorar a clareza e fornecer contexto imediato para esses problemas.

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 Copilot gerar um sub-problema que não pertence à árvore de problemas, você poderá desvinculá-lo da árvore de problemas.

1. Na árvore de problemas do workbench, clique ao lado do subproblema e clique em Desvincular subproblema.
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 suas questões de projeto, é possível atribuí-las aos membros certos da equipe ou até mesmo ao Copilot para obter assistência adicional. Para saber mais sobre como atribuir Copilot ou colaboradores a problemas e como continuar planejando e implementando seu projeto com Copilotos recursos de agente, consulte Solicitando GitHub Copilot criar uma solicitação de pull.

Leitura adicional

•         [AUTOTITLE](/copilot/how-tos/use-copilot-for-common-tasks/use-copilot-to-create-or-update-issues)
  

•         [AUTOTITLE](/copilot/tutorials/cloud-agent/pilot-cloud-agent)
  

•         [AUTOTITLE](/copilot/tutorials/cloud-agent/get-the-best-results)
  

•         [AUTOTITLE](/copilot/tutorials/speed-up-development-work)