Configuração do LSP para Copilot CLI do GitHub

HABILIDADE UTILITÁRIA — instala e configura servidores do Protocolo de Servidor de Linguagem (LSP) para o Copilot CLI. USE PARA: "configurar LSP", "instalar servidor de linguagem", "configurar LSP para Java", "adicionar TypeScript LSP", "ativar inteligência de código", "preciso de ir para definição", "encontrar referências não está funcionando", "preciso de melhor compreensão de código" NÃO USE PARA: tarefas gerais de codificação, configuração de LSP de IDE/editor, configurações que não sejam do Copilot CLI

Fluxo de Trabalho

1. Pergunte a linguagem — use ask_user para perguntar para qual(is) linguagem(ns) de programação o usuário deseja suporte de LSP
2. Detecte o SO — execute uname -s (ou verifique se é Windows via $env:OS / %OS%) para determinar macOS, Linux ou Windows
3. Procure o servidor LSP — leia references/lsp-servers.md para servidores conhecidos, comandos de instalação e trechos de configuração
4. Pergunte o escopo — use ask_user para perguntar se a configuração deve ser em nível de usuário (~/.copilot/lsp-config.json) ou em nível de repositório (lsp.json na raiz do repositório ou .github/lsp.json)
5. Instale o servidor — execute o comando de instalação apropriado para o SO detectado
6. Escreva a configuração — mescle a nova entrada do servidor no arquivo de configuração escolhido (~/.copilot/lsp-config.json para nível de usuário; lsp.json ou .github/lsp.json para nível de repositório). Se uma configuração em nível de repositório já existir, continue usando essa localização; caso contrário, pergunte ao usuário qual localização em nível de repositório ele prefere. Crie o arquivo se estiver faltando e preserve as entradas existentes.
7. Verifique — confirme se o binário do LSP está em $PATH e se o arquivo de configuração é JSON válido

Formato de Configuração

O Copilot CLI lê a configuração do LSP de locais em nível de usuário ou em nível de repositório, e a configuração em nível de repositório tem precedência sobre a configuração em nível de usuário:

• Nível de usuário: ~/.copilot/lsp-config.json
• Nível de repositório: lsp.json (raiz do repositório) ou .github/lsp.json

A estrutura JSON:

{
  "lspServers": {
    "<server-key>": {
      "command": "<binary>",
      "args": ["--stdio"],
      "fileExtensions": {
        ".<ext>": "<languageId>",
        ".<ext2>": "<languageId>"
      }
    }
  }
}

Regras Chave

• command é o nome do binário (deve estar em $PATH) ou um caminho absoluto.
• args quase sempre inclui "--stdio" para usar transporte de E/S padrão.
• fileExtensions mapeia cada extensão de arquivo (com ponto inicial) para um Identificador de Linguagem.
• Múltiplos servidores podem coexistir em lspServers.
• Ao mesclar em um arquivo existente, nunca sobrescreva outras entradas de servidor — apenas adicione ou atualize a chave de linguagem de destino.

Comportamento

• Sempre use ask_user com choices ao pedir ao usuário para escolher uma linguagem ou escopo.
• Se a linguagem não estiver listada em references/lsp-servers.md, pesquise na web por "<linguagem> LSP server" e guie o usuário através da configuração manual.
• Se um gerenciador de pacotes não estiver disponível (por exemplo, sem Homebrew no macOS), sugira métodos de instalação alternativos do arquivo de referência.
• Após a instalação, execute which <binary> (ou where.exe no Windows) para confirmar que o binário é acessível.
• Mostre ao usuário o JSON de configuração final antes de gravá-lo.
• Se o arquivo de configuração já existir, leia-o primeiro e mescle — não sobrescreva.

Verificação

Após a configuração, diga ao usuário:

1. Digite /exit para sair do Copilot CLI — isso é obrigatório para que a nova configuração do LSP seja carregada no próximo lançamento
2. Reinicie copilot em um projeto com arquivos da linguagem configurada
3. Execute /lsp para verificar o status do servidor
4. Tente recursos de inteligência de código como ir para definição ou pairar