Pergunte ao Copilot

Visão Geral

Esta habilidade permite que o agente interaja com o GitHub Copilot CLI (copilot) em modo não interativo (headless). Use esta habilidade quando o usuário explicitamente desejar conselhos secundários, revisões de código, explicações ou geração de código dos modelos do GitHub Copilot.

Use source: self e source_type: self quando a habilidade for original deste repositório e não exigir crédito de fonte externa no README.

Copilot é um serviço externo. Trate prompts, caminhos de arquivo, trechos, conteúdo de repositório, saída de comando e sugestões geradas como dados que podem sair do ambiente local.

Quando Usar Esta Habilidade

• Somente Solicitação do Usuário: Use esta habilidade SOMENTE quando o usuário explicitamente pedir para "consultar o Copilot", "perguntar ao Copilot", "revisar com o Copilot" ou solicitar explicitamente uma segunda opinião usando o Copilot.
• NÃO Invoque Automaticamente: Para cumprir as políticas de privacidade, o agente não deve invocar esta habilidade automaticamente para suas próprias segundas opiniões ou verificações sem o consentimento explícito do usuário.

Como Funciona

Etapa 1: Solicitar Consentimento Explícito do Usuário

Antes de executar qualquer comando que referencie arquivos locais, caminhos de repositório, trechos, saída de comando, configuração adjacente a segredos ou contexto de projeto privado, você DEVE obter consentimento explícito do usuário para enviar esse material ao GitHub Copilot.

Peça aprovação separada antes de permitir que o Copilot execute ferramentas, execute comandos shell, edite arquivos, instale pacotes ou modifique o espaço de trabalho.

Etapa 2: Executar com Sinalizadores Mínimos Permitidos

Para evitar travamentos da TUI, execute o comando copilot com sinalizadores headless. Não use desvios gerais como --yolo, --allow-all-tools ou --allow-all-paths para perguntas e respostas ou revisões rotineiras.

• Para Tarefas Somente Leitura / Perguntas Gerais: Envie apenas o texto aprovado e redigido pelo usuário no prompt. Não conceda ao Copilot acesso amplo a caminhos locais; não é necessário quando o prompt já contém o contexto aprovado.
• Para Tarefas de Mutação Confiáveis: Prefira um sinalizador de permissão com escopo, se a CLI o suportar. Use desvios de mutação gerais apenas depois que o usuário autorizar explicitamente o Copilot a executar ferramentas e modificar o espaço de trabalho para a tarefa específica.

Etapa 3: Usar Gerenciamento de Sessão (Opcional)

Para manter o contexto da conversa, use os sinalizadores --name e --resume, ou passe um --session-id em chamadas subsequentes.

Exemplos

Exemplo 1: Pergunta Geral (Somente Leitura)

Não requer acesso ao caminho do repositório ou permissões de mutação.

copilot -p "Explain how to implement a debounce function in TypeScript" -s

Exemplo 2: Revisão de Código (Trecho de Arquivo Aprovado)

Sempre confirme o arquivo exato e o trecho com o usuário antes de executar. Mantenha o caminho em uma variável entre aspas; construa o prompt a partir de uma instrução estática mais o trecho aprovado. O shell não reavalia a saída de substituição de comando, portanto, metacaracteres dentro do arquivo revisado permanecem como texto do prompt em vez de sintaxe do shell:

review_file="path/to/file.ts"
test -f "$review_file" || { echo "File not found: $review_file" >&2; exit 1; }
copilot -p "$(printf '%s\n\n' 'Review this approved excerpt for potential memory leaks:'; sed -n '1,220p' -- "$review_file")" -s

Nunca construa um comando shell interpolando texto de prompt controlado pelo usuário, caminhos, conteúdo de problema ou nomes de arquivos na origem do shell. Use estrutura de comando fixa, variáveis entre aspas e apenas conteúdo de arquivo aprovado.

Exemplo 3: Gerenciamento de Sessão Nomeada

copilot -p "Remember this session label for follow-up questions." -s --name "my-session-name"
copilot -p "Summarize the prior advice in this session." -s --resume "my-session-name"

Melhores Práticas

• ✅ Faça: Peça consentimento ao usuário antes de enviar quaisquer arquivos de projeto para endpoints de terceiros.
• ✅ Faça: Envie apenas o trecho aprovado e redigido; mantenha o Copilot fora do espaço de trabalho mais amplo.
• ✅ Faça: Mantenha valores não confiáveis em variáveis entre aspas ou entrada de comando, nunca na origem do shell.
• ✅ Faça: Use -s (silencioso) para suprimir metadados e estatísticas, deixando apenas a saída limpa.
• ❌ Não faça: Acione esta habilidade automaticamente para segundas opiniões em segundo plano sem a solicitação explícita do usuário.
• ❌ Não faça: Envie arquivos, logs, detalhes de ambiente ou contexto de repositório privado para o Copilot sem aprovação explícita.
• ❌ Não faça: use --allow-all-paths para uma revisão, ou interpole texto não confiável dentro de copilot -p "...".
• ❌ Não faça: Execute copilot sem sinalizadores de bypass de permissão em tarefas em segundo plano, pois ele ficará travado esperando por entrada interativa.

Limitações

…