Awesome CopilotAdventures

Documentação do produto verificada

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

  1. Ask: solicite um rastreamento do código real com caminhos e incertezas.
  2. Plan: peça critérios de aceitação, arquivos afetados, riscos, validação e uma condição de parada.
  3. Agent: implemente um recorte aprovado e inspecione seu diff e a saída real das ferramentas.
  4. 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.md aninhado 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

Buscar

Busca em português do Brasil. Os caminhos e os exemplos executáveis mantêm o texto original.