Conceitos do Copilot para a prática
Cinco perguntas antes de uma tarefa
| Pergunta | Conceito | Exemplo |
|---|---|---|
| Qual responsabilidade é necessária? | Papel | Ask investiga; Plan projeta; Agent implementa |
| Qual runtime controla as ferramentas? | Harness | VS Code Local ou Copilot Agent Host |
| Qual destino está selecionado? | Destino da sessão | Local, Copilot ou um destino Cloud disponível |
| Onde ficam os arquivos e processos? | Ambiente | Pasta descartável, worktree, Codespace |
| O que esta sessão pode fazer? | Permissões | Ler, editar, executar, acessar a rede, aprovações explícitas |
O modelo é outra escolha, não um sinônimo de qualquer linha. As capturas antigas fornecidas com o material importado mostram layouts anteriores da interface. Use a Paleta de Comandos atual e a documentação abaixo; não deduza o status atual de funcionalidades, acesso a modelos ou valores padrão de configurações a partir dessas imagens.
Escolha o menor fluxo de trabalho útil
- Ask: solicite um rastreamento do código real com caminhos e incertezas.
- Plan: peça critérios de aceitação, arquivos afetados, riscos, validação e uma condição de parada.
- Agent: implemente um recorte aprovado e inspecione seu diff e a saída real das ferramentas.
- Revisão: compare o resultado com os critérios de aceitação em um contexto limpo.
O planejamento também é útil para pequenas alterações arriscadas. Agent pode planejar internamente; os três papéis não são três botões obrigatórios do produto em toda CLI ou harness.
Exemplo: uma funcionalidade de busca na biblioteca
Ask: Trace the console action to the repository. Cite the files you inspected.
Separate what the code already does from what the requirement requests. Do not edit.
Plan: Add case-insensitive title search. Preserve existing loan and return behavior.
List the contract, empty/missing input cases, changed files, and focused test command.
Do not assume a whole book is unavailable because one physical copy is on loan.
Agent: Implement only the reviewed search slice in this disposable workspace.
Run the specified tests, report exit codes, and stop after two unsuccessful repairs
to explain the blocker. Do not change unrelated projects or publish a branch.
Contexto é evidência selecionada, não o repositório inteiro
Anexe o menor arquivo ou seleção útil, mas também siga interfaces,
chamadores, testes e dados relevantes. #codebase solicita recuperação; não garante que todos os
arquivos sejam colocados no contexto do modelo. Fechar uma aba não comprova que o arquivo esteja inacessível.
Arquivos de instruções influenciam respostas. Não impõem restrições de sistema de arquivos, não garantem qualidade de código nem alteram o modelo de permissões. Resolva diretamente arquivos de instruções conflitantes: a documentação do VS Code não promete uma ordem de precedência ao combiná-los. Conclusões inline não são o mesmo fluxo de chat que leva instruções em conta.
Opções de personalização
| Necessidade | Use | Evidência de carregamento |
|---|---|---|
| Convenções do repositório | .github/copilot-instructions.md |
Inspecionar instruções/referências descobertas |
| Convenções específicas por caminho | .github/instructions/*.instructions.md |
Fazer applyTo corresponder ao caminho real da fonte |
| Tarefa invocada manualmente | .github/prompts/*.prompt.md |
Invocar em uma sessão Local com suporte |
| Conhecimento especializado reutilizável | .github/skills/<name>/SKILL.md |
Verificar descoberta e invocação relevante |
| Seleção de papel e ferramentas | .github/agents/*.agent.md |
Inspecionar perfil e ferramentas disponíveis |
| Capacidades externas | Configuração MCP revisada | Descobrir uma ferramenta e verificar seu resultado |
| Verificação determinística de ciclo de vida | Hook | Observar entrada, saída e status de saída do hook |
[!WARNING] Hooks do VS Code e hooks com escopo de agente estão em versão prévia (Preview). O suporte a
AGENTS.mdaninhado e ferramentas extras do agente Plan são experimentais onde documentado. A disponibilidade é afetada pela política da organização.
[!IMPORTANT] Sessões do VS Code Agent Host não usam arquivos de prompt. Para o layout de comandos de barra do Spec Kit, use uma sessão Local com suporte. A integração fixada do Spec Kit v1.0.4 gera skills por padrão; consulte a referência versionada. Não presuma que copiar um prompt antigo para uma skill preserve seus scripts ou argumentos.
Funcionalidades não são direitos de acesso
Não altere um repositório privado para público apenas para concluir um laboratório. Não fixe cotas de plano, contagens de solicitações ou um modelo específico como universalmente disponíveis. Registre as capacidades realmente disponíveis para sua conta. As evidências de exercícios locais/offline devem ser identificadas separadamente da execução na nuvem ou da execução real do SDK.
Registro de fontes
Verificado em 2026-09-06. Estas são referências de produto, não cópias de saídas de chat.
| Assunto | Fonte oficial | Limite usado nesta trilha |
|---|---|---|
| Configuração | Configurar o Copilot | Acesso da conta; os rótulos da interface podem mudar |
| Harnesses | Escolher um harness | Cloud é um destino; worktrees não são sandboxes |
| Planejamento | Planejar com agentes | Revisão antes da implementação; ferramentas extras são experimentais |
| Instruções | Instruções personalizadas | Escopo; sem ordem garantida de combinação |
| Arquivos de prompt | Arquivos de prompt | Harness Local versus Agent Host |
| Skills | Agent Skills | Carregamento por relevância não é execução determinística |
| Agentes | Agentes personalizados | Nomes de ferramentas e transferências diferem por superfície |
| Hooks | Hooks | Versão prévia (Preview); inspecionar comandos executáveis |
| Nuvem | Iniciar sessões na nuvem | Trabalho remoto e evidências de PR exigem acesso |
| Testes | C#, Python | Descoberta, compilação e execução são separadas |