O GitHub Copilot Workspace é um novo ambiente de desenvolvimento baseado em navegador que se conecta diretamente às suas issues do GitHub. Em vez de alternar entre o rastreador de issues, IDE local e documentação, você pode ler a issue, planejar uma correção, escrever código e testar alterações tudo em uma interface alimentada pelo Copilot. Este passo a passo explica como usar o Copilot Workspace para desenvolvimento orientado a issues, desde selecionar uma issue até revisar o pull request gerado.
A ideia central por trás do Copilot Workspace é reduzir o atrito entre identificar um problema e entregar uma solução. Ele usa o contexto do seu repositório, a descrição da issue e o histórico da conversa para sugerir um plano concreto e alterações de código. Isso é especialmente útil para desenvolvedores que desejam corrigir bugs ou adicionar funcionalidades sem precisar analisar manualmente toda a base de código primeiro.
Este artigo cobre o fluxo de trabalho completo: abrir o Copilot Workspace, interpretar uma issue, refinar o plano gerado por IA, aplicar alterações de código e criar um pull request. Você também aprenderá a lidar com issues incompletas ou ambíguas e como revisar as alterações antes de confirmá-las.
Principais Conclusões: Desenvolvimento Orientado a Issues com Copilot Workspace
- GitHub.com > página da issue > botão Open in Workspace: Inicia o Copilot Workspace diretamente de qualquer issue do repositório.
- Painel do Workspace > guia Plan: Mostra o plano passo a passo gerado por IA para resolver a issue selecionada.
- Painel do Workspace > guia Code: Exibe as alterações de código propostas com visualizações diff para cada arquivo.
O que é o GitHub Copilot Workspace e como funciona
O Copilot Workspace é um ambiente de desenvolvimento alimentado pelo Copilot que roda inteiramente no navegador. Ele se integra com issues, pull requests e conteúdos do repositório do GitHub. Quando você abre uma issue no Workspace, o sistema lê o título, descrição, comentários e labels da issue. Ele também busca os arquivos relevantes do seu repositório, incluindo código, configuração e documentação.
O ambiente usa o modelo GPT-4 ajustado para tarefas de código e engenharia de software. Ele gera um plano de ação que descreve quais arquivos modificar e como. Você pode editar o plano, adicionar ou remover etapas e fazer perguntas esclarecedoras antes de o sistema escrever qualquer código. Após aprovar o plano, o Copilot Workspace produz um conjunto de alterações de código mostradas como um diff. Você pode revisar cada alteração, editá-la inline e, finalmente, criar um pull request a partir do workspace.
Pré-requisitos para usar o Copilot Workspace
Para usar o Copilot Workspace, você precisa de uma conta GitHub com uma assinatura ativa do Copilot. O Copilot Workspace está disponível para assinantes do Copilot Enterprise, Copilot Business e Copilot Individual. O repositório deve ser público ou privado com acesso ao Copilot habilitado. Nenhuma instalação local é necessária, pois tudo roda no navegador.
Passos para usar o Copilot Workspace no desenvolvimento orientado a issues
Esta seção percorre o fluxo de trabalho completo, desde abrir uma issue até criar um pull request. Todas as etapas são realizadas no navegador.
- Abra a issue no seu repositório
Navegue até o repositório no GitHub.com. Clique na guia Issues e selecione a issue na qual deseja trabalhar. A issue deve ter um título e descrição claros. Se faltar contexto, adicione comentários ou labels para ajudar o Copilot a entender o escopo. - Clique no botão Open in Workspace
Na página da issue, localize o botão Open in Workspace. Ele aparece próximo ao canto superior direito do corpo da issue, ao lado das seções Assignees e Labels. Clicar neste botão abre uma nova guia do navegador com o Copilot Workspace carregado para essa issue específica. - Revise o plano gerado na guia Plan
O Copilot Workspace exibe um plano na guia Plan. O plano lista os arquivos que precisam de alterações, o tipo de alteração para cada arquivo e um resumo da lógica. Leia cada etapa com atenção. Se o plano estiver incorreto ou incompleto, clique no botão Edit abaixo do plano. Você pode adicionar novas etapas, reordená-las ou excluir as irrelevantes. - Faça perguntas esclarecedoras se necessário
Abaixo do plano, há um campo de entrada de chat. Você pode digitar perguntas como: Por que essa alteração é necessária no módulo de autenticação? ou Devemos também atualizar o arquivo de teste?. O Copilot responde com explicações e pode atualizar o plano automaticamente com base no seu feedback. - Aprove o plano para gerar alterações de código
Quando estiver satisfeito com o plano, clique no botão Approve and Generate Code. O Copilot Workspace cria as alterações de código e as mostra na guia Code. Cada arquivo modificado aparece com uma visualização diff lado a lado. O lado esquerdo mostra o arquivo original e o lado direito mostra a versão proposta. - Revise e edite as alterações de código inline
Na guia Code, você pode clicar em qualquer linha do diff para editá-la diretamente. Você pode adicionar novas linhas, excluir linhas ou modificar o código gerado pelo Copilot. O ambiente valida a sintaxe para linguagens suportadas, mas não executa testes automaticamente neste estágio. - Crie um pull request a partir do workspace
Após revisar e editar as alterações, clique no botão Create Pull Request. O Copilot Workspace cria um novo pull request no seu repositório. O pull request inclui a referência da issue no título e na descrição. O nome do branch é gerado automaticamente com base no número e título da issue.
Problemas comuns e o que evitar
O Copilot Workspace é poderoso, mas tem limitações. Entendê-las ajudará você a evitar tempo perdido e alterações incorretas.
O Copilot Workspace gera um plano incompleto
Se a descrição da issue for vaga, o plano gerado pode pular etapas importantes. Por exemplo, uma issue que diz Corrigir erro de login sem um stack trace ou passos de reprodução produzirá um plano genérico. Para corrigir isso, edite a issue antes de abri-la no Workspace. Adicione mensagens de erro específicas, comportamento esperado e arquivos afetados. Você também pode usar o chat no Workspace para pedir ao Copilot que reanalise a issue com mais contexto.
Alterações de código não compilam ou falham nos testes
O Copilot Workspace gera código com base no snapshot do repositório e no contexto da issue. Ele não executa seu conjunto de testes ou sistema de build. Após criar o pull request, seu pipeline de CI executará os testes normalmente. Se os testes falharem, edite as alterações diretamente no branch do pull request usando o editor web do GitHub ou seu IDE local. Você também pode retornar ao Copilot Workspace, ajustar o plano e regenerar o código para a mesma issue.
O Copilot Workspace modifica arquivos fora do escopo da issue
Às vezes, a IA sugere alterações em arquivos que não estão diretamente relacionados à issue. Isso pode acontecer se a descrição da issue mencionar um conceito amplo. Para evitar isso, revise o plano com cuidado e remova qualquer etapa que modifique arquivos que você não deseja alterar. Na guia Plan, clique no botão X ao lado de uma etapa para excluí-la. Você também pode adicionar restrições explícitas no chat, como Modificar apenas arquivos no diretório src/controllers.
| Item | Copilot Workspace | Fluxo de Trabalho Tradicional com IDE Local |
|---|---|---|
| Configuração necessária | Nenhuma além do navegador e login no GitHub | Clonar repositório, instalar dependências, configurar IDE |
| Coleta de contexto | Automática a partir da issue, repositório e comentários | Leitura manual da issue, código e documentação |
| Geração do plano | Plano gerado por IA com etapas editáveis | Desenvolvedor cria plano mental ou escrito |
| Geração de código | IA escreve código após aprovação do plano | Desenvolvedor escreve código manualmente |
| Criação do pull request | Um clique a partir do workspace | Comandos git manuais ou plugin do IDE |
O Copilot Workspace não substitui seu ambiente de desenvolvimento local. Ele é mais indicado para correções rápidas, pequenas funcionalidades e bugs bem definidos. Para refatorações grandes ou alterações complexas de arquitetura, você ainda deve usar seu IDE local com o Copilot para sugestões de código.
Após criar um pull request a partir do Copilot Workspace, você pode continuar trabalhando nele localmente. O branch criado pelo Workspace é um branch Git padrão. Você pode puxá-lo para sua máquina local, fazer alterações adicionais e enviar atualizações. A sessão do Workspace permanece disponível para referência até que você a feche.
Para equipes, o Copilot Workspace ajuda a padronizar a forma como as issues são resolvidas. Cada alteração está vinculada a uma issue, e o plano fornece um registro claro da abordagem pretendida. Isso facilita as revisões de código, pois os revisores podem ver tanto o plano quanto o diff resultante no pull request.