Copilot Spaces

Use Copilot Spaces para trazer contexto curado e específico do projeto para as conversas. Um Space é uma coleção compartilhada de repositórios, arquivos, documentação e instruções que fundamentam as respostas do Copilot no código e no conhecimento reais da sua equipe.

Ferramentas Disponíveis

Ferramentas MCP (Somente Leitura)

REST API via gh api (CRUD Completo)

A API REST de Spaces suporta a criação, atualização, exclusão de spaces e gerenciamento de colaboradores. O servidor MCP expõe apenas operações de leitura, portanto, use gh api para escritas.

User Spaces:

Organization Spaces: Mesmo padrão em /orgs/{org}/copilot-spaces/...

Colaboradores: Adicionar, listar, atualizar e remover colaboradores em .../collaborators

Requisitos de escopo: PAT precisa de read:user para leituras, user para escritas. Adicionar com gh auth refresh -h github.com -s user.

Observação: Esta API está funcional, mas ainda não está na documentação pública da API REST. Pode exigir o sinalizador de recurso copilot_spaces_api.

Quando Usar Spaces

• O usuário menciona "Copilot space" ou pede para "carregar um space"
• O usuário quer respostas fundamentadas em documentação, código ou padrões específicos do projeto
• O usuário pergunta "quais spaces estão disponíveis?" ou "encontrar um space para X"
• O usuário precisa de contexto de integração, documentação de arquitetura ou orientação específica da equipe
• O usuário quer seguir um fluxo de trabalho estruturado definido em um Space (modelos, checklists, processos de várias etapas)

Fluxo de Trabalho

1. Descobrir Spaces

Quando um usuário pergunta quais spaces estão disponíveis ou você precisa encontrar o space correto:

Call mcp__github__list_copilot_spaces

Isso retorna todos os spaces que o usuário pode acessar, cada um com um name e owner_login. Apresente correspondências relevantes ao usuário.

Para filtrar os spaces de um usuário específico, combine owner_login com o nome de usuário (por exemplo, "mostre meus spaces").

2. Carregar um Space

Quando um usuário nomeia um space específico ou você identificou o correto:

Call mcp__github__get_copilot_space with:
  owner: "org-or-user"    (the owner_login from the list)
  name: "Space Name"      (exact space name, case-sensitive)

Isso retorna o conteúdo completo do space: documentação anexada, contexto de código, instruções personalizadas e quaisquer outros materiais curados. Use este contexto para informar suas respostas.

3. Seguir as Pistas

O conteúdo do Space frequentemente faz referência a recursos externos: issues do GitHub, dashboards, repositórios, discussões ou outras ferramentas. Busque proativamente esses recursos usando outras ferramentas MCP para coletar o contexto completo. Por exemplo:

• Um space referencia uma issue de acompanhamento de iniciativa. Use issue_read para obter os comentários mais recentes.
• Um space vincula a um quadro de projeto. Use ferramentas de projeto para verificar o status atual.
• Um space menciona o plano mestre de um repositório. Use get_file_contents para lê-lo.

4. Responder ou Executar

Uma vez carregado, use o conteúdo do space com base no que ele contém:

Se o space contiver material de referência (documentos, código, padrões):

• Responda a perguntas sobre a arquitetura, padrões ou padrões do projeto
• Gere código que siga as convenções da equipe
• Depure problemas usando conhecimento específico do projeto

Se o space contiver instruções de fluxo de trabalho (modelos, processos passo a passo):

• Siga o fluxo de trabalho conforme definido, passo a passo
• Colete dados das fontes que o fluxo de trabalho especifica
• Produza a saída no formato que o fluxo de trabalho define
• Mostre o progresso após cada etapa para que o usuário possa direcionar

5. Gerenciar Spaces (via gh api)

Quando um usuário deseja criar, atualizar ou excluir um space, use gh api. Primeiro, encontre o número do space no endpoint de listagem.

Atualizar as instruções de um space:

gh api users/{username}/copilot-spaces/{number} \
  -X PUT \
  -f general_instructions="New instructions here"

Atualizar nome, descrição ou instruções juntos:

gh api users/{username}/copilot-spaces/{number} \
  -X PUT \
  -f name="Nome Atualizado" \
  -f description="Descrição Atualizada" \
  -f general_instructions="Instruções Atualizadas"

…