Partilhar via

Cenários e referências de competências

GitHub Copilot modernização para .NET ajuda-te a modernizar através de cenários e competências:

  • Cenários são fluxos de trabalho geridos de ponta a ponta para objetivos de atualização importantes, como a atualização do .NET Framework para o .NET 10. Os cenários coordenam todo o ciclo de vida: avaliação, planeamento e execução tarefa a tarefa.
  • As competências são capacidades focadas em tarefas específicas de atualização, como converter EF6 para EF Core ou substituir WCF por CoreWCF. As habilidades ativam-se automaticamente quando o agente encontra código relevante durante uma atualização.

O agente suporta projetos tanto em C# como em Visual Basic.

Sugestão

Não precisas de memorizar nomes. Descreve o que queres ("atualiza para .NET 10", "atualiza o meu código EF6", "substitui Newtonsoft.Json") e o agente carrega automaticamente o cenário e as competências corretas. Também pode perguntar: "Com o que me pode ajudar?"

Cenários

Os cenários são os fluxos de trabalho de atualização de topo do agente. Quando inicia uma conversa, o agente identifica o melhor cenário para o seu objetivo e guia-o passo a passo.

Scenario O que faz Exemplo de prompt
.NET Atualiza projetos de qualquer versão antiga de .NET para .NET 8 ou posterior. "Atualizar a minha solução para .NET 10"
Conversão ao estilo SDK Converte ficheiros de projeto legados para formato moderno de SDK. "Converter os meus projetos para o estilo SDK"
Atualização Newtonsoft.Json Substitui Newtonsoft.Json por System.Text.Json através de uma solução. "Atualização do Newtonsoft.Json"
Atualização do SqlClient Atualiza System.Data.SqlClient para Microsoft. Data.SqlClient. "Atualizar o SqlClient para o pacote moderno"
Funções do Azure Atualiza o Funções do Azure de modelo em processo para trabalhador isolado. "Atualizar o meu Funções do Azure"
Kernel Semântico para Agentes Atualizações dos SK Agents para o Microsoft Agent Framework. "Melhorar os meus agentes SK"

Para um guia de ponta a ponta, consulte os conceitos principais.

Atualização da versão .NET

O cenário mais comum. Atualiza os seus projetos de qualquer variante mais antiga de .NET para a mais recente:

Fonte Target
Framework .NET (qualquer versão) .NET 8 ou posterior
.NET Core 1.x–3.x .NET 8 ou posterior
.NET 5 ou posterior .NET 8 ou posterior

O agente analisa o seu gráfico de dependências, verifica a compatibilidade com o NuGet, identifica alterações que interrompem e cria um plano de tarefa usando a melhor estratégia para a sua solução (de baixo para cima, de cima para baixo ou tudo de uma vez). Se os teus projetos precisarem de conversões de formato, o agente trata delas automaticamente como parte da atualização.

Conversão ao estilo SDK

Converte ficheiros legados .csproj.vbproj e para o formato moderno de SDK sem alterar frameworks de destino. O agente trata da conversão automaticamente durante as atualizações de versão. Executa este cenário de forma independente, se necessário.

Atualização Newtonsoft.Json

Substitui Newtonsoft.Json por System.Text.Json toda a sua solução. Trata de conversores personalizados, [JsonProperty] atributos, JObject/JArray utilização e definições de serialização.

Atualização do SqlClient

Melhorias de System.Data.SqlClient para Microsoft.Data.SqlClient. Lida com a mudança de comportamento padrão Encrypt=true e cadeia de ligação diferenças.

Funções do Azure upgrade

As atualizações Funções do Azure do modelo de alojamento em processo para o modelo de trabalhador isolado com Program.cs e HostApplicationBuilder. Inclui atualização do Application Insights.

Kernel Semântico para Microsoft Agent Framework

Atualizações de Kernel Semântico Agentes (ChatCompletionAgent, OpenAIAssistantAgent) para Microsoft Agent Framework. Atualiza pacotes e padrões de API.

Habilidades de melhoria: comuns

Competências de atualização de uso geral que se aplicam a vários tipos de projetos.

Skill O que faz
Conversão para o estilo SDK Converte ficheiros de projeto legados para formato moderno de SDK. Utiliza ordenação topológica para soluções multi-projeto.
A atualizar o Autofac para .NET DI Remove completamente o Autofac e atualiza todos os registos para a injeção de dependência ASP.NET Core incorporada.
Integração do Autofac com .NET Mantém o Autofac como contentor DI, mas moderniza a integração ASP.NET Core.
Atualização dos namespaces de criptografia Corrige a System.Security.Cryptography divisão do espaço de nomes para tipos como X509Certificate2 e SignedCms.
Atualização do Newtonsoft para System.Text.Json Atualização completa a partir de Newtonsoft.Json. Trata de conversores, atributos, tipos dinâmicos e definições.
Atualizar Kernel Semântico para Agentes Atualiza as APIs do Kernel Semântico Agent para o Microsoft Agents AI Framework.
A atualizar para MSMQ. Mensagens Atualizações de System.Messaging (apenas .NET Framework) para MSMQ.Messaging para .NET Core.
Conversão para Gestão Central de Pacotes Converte o versionamento de pacotes NuGet por projeto em gestão centralizada de pacotes usando Directory.Packages.props.
Modernizar a versão C# Atualiza o código C# para usar funcionalidades de linguagem mais recentes (C# 7.0 a 15). Faz lotes alterações mecânicas e dotnet format utiliza o julgamento do LLM para transformações semânticas.
Atualização de referências anuláveis em C# Ativa tipos de referência anuláveis e resolve sistematicamente todos os avisos CS86xx. Abrange estratégias de implementação, orientações de anotação e considerações específicas do framework.

Atualizar competências: acesso a dados

Competências para atualizar camadas de acesso a dados, incluindo Entity Framework, LINQ para SQL e bibliotecas clientes SQL.

Skill O que faz
Atualização do EDMX para Code-First Converte modelos EF6 Database-First (.edmx) para EF Core Code-First. Estruturas de estruturas a partir da base de dados.
Atualização do EF DbContext Regista DbContext em ASP.NET Core injeção de dependência. Trata tanto de EF6 para EF Core como de padrões EF Core existentes.
Atualização do EF6 Code-First para o EF Core Atualiza o EF6 Code-First para EF Core. Troca de pacotes, atualiza namespaces e substitui EntityTypeConfiguration e DbModelBuilder.
A atualizar para Microsoft. Data.SqlClient Melhorias a partir de System.Data.SqlClient. Lida com a alteração Encrypt=true por defeito e cadeia de ligação diferenças.

Atualizar competências: web e ASP.NET

Competências para atualizar aplicações do ASP.NET Framework para ASP.NET Core.

Atualização do framework ASP.NET

Skill O que faz
Atualização ASP.NET Framework para Core Atualização abrangente do ASP.NET Framework (MVC/WebAPI) para ASP.NET Core, incluindo controladores, vistas, middleware, autenticação e configuração.
Atualizar ASP.NET Identidade Atualizações ASP.NET MVC Identidade para ASP.NET Core Identidade, incluindo IdentityDbContext, UserManager, SignInManager e middleware de autenticação.
Atualização do Global.asax Converte Global.asax eventos do ciclo de vida (Application_Start, Application_Error) em ASP.NET Core Program.cs e middleware.
Atualização do OWIN para middleware Substitui o middleware OWIN/Katana (IAppBuilder, OwinMiddleware) por equivalentes ASP.NET Core.
Atualização da Autenticação de Cookies OWIN Atualiza o middleware de autenticação de cookies OWIN para a autenticação de cookies ASP.NET Core.
Atualização do OWIN OAuth para JWT Atualiza a autenticação do token portador OWIN OAuth para a autenticação do portador ASP.NET Core JWT.
Atualização do OWIN OpenID Connect Atualiza o middleware OWIN OpenID Connect para a autenticação ASP.NET Core OpenID Connect.

Características do MVC

Skill O que faz
Atualização da autenticação MVC Atualiza a autenticação ASP.NET MVC para ASP.NET Core Identity e middleware de autenticação.
Atualização do agrupamento MVC Converte System.Web.Optimization o agrupamento em etiquetas diretas <script>/<link> ou bundlers modernos.
Atualização da configuração do MVC Atualizações web.config e app.config definições do sistema de configuração ASP.NET Core (appsettings.json, variáveis de ambiente).
Atualização da negociação de conteúdos MVC Atualiza padrões de negociação de conteúdos e formateadores para o ASP.NET Core.
Atualização dos controladores MVC Atualiza controladores MVC e WebAPI para padrões de controladores ASP.NET Core.
Atualização da injeção de dependência de MVC Atualiza os registos de contentores DI para a injeção de dependência incorporada no ASP.NET Core.
Atualização dos filtros MVC Converte filtros globais de MVC (FilterConfig, GlobalFilters) em middleware ASP.NET Core e pipeline de filtros.
Atualização do pipeline HTTP MVC Atualiza módulos HTTP e handlers para middleware ASP.NET Core.
Atualização do MVC HttpContext Upgrades System.Web.HttpContext uso para ASP.NET Core HttpContext.
Atualização do registo do MVC Atualizações a registar para Microsoft.Extensions.Logging.
Atualização da encadernação de modelos MVC Atualiza padrões de binding de modelo para binding de modelo ASP.NET Core.
Melhoria das vistas do MVC Razor Atualiza as vistas, layouts e componentes de visualização do Razor para ASP.NET Core Razor.
Atualização do encaminhamento MVC Converte o encaminhamento RouteCollection para o encaminhamento ASP.NET Core endpoint (MapControllerRoute, roteamento por atributos).
Atualização do estado da sessão MVC Atualiza o estado da sessão para a sessão distribuída ASP.NET Core.
Atualização de ficheiros estáticos MVC Atualiza o tratamento de ficheiros estáticos para o middleware de ficheiros estáticos do ASP.NET Core.
Atualização dos adaptadores MVC System.Web Utiliza adaptadores System.Web para atualização incremental do ASP.NET Framework para o ASP.NET Core.
Atualização da validação do MVC Atualiza atributos e padrões de validação para validação ASP.NET Core.

WCF

Skill O que faz
Atualização do WCF para CoreWCF Atualiza os serviços WCF do lado do servidor para CoreWCF para .NET 6+. Converte hosting, bindings, extensões de comportamento e contratos assíncronos.

Competências de atualização: cloud e Azure

Skill O que faz
Atualização Funções do Azure Arranque As atualizações Funções do Azure da classe em processo Startup para o modelo de trabalhador isolado com Program.cs.
A atualizar Funções do Azure para v2 As atualizações Funções do Azure ao padrão de alojamento v2 usando IHostApplicationBuilder.
Atualizar Azure Key Vault Atualiza o SDK Azure Key Vault legado para as bibliotecas modernas Azure.Security.KeyVault.
Upgrade Azure Service Bus Atualiza o SDK Azure Service Bus legado para a moderna biblioteca Azure.Messaging.ServiceBus.
A atualizar Armazenamento do Azure Atualiza o SDK Armazenamento do Azure legado para as bibliotecas modernas Azure.Storage.

Melhorar competências: bibliotecas

Skill O que faz
Atualização de ADAL para MSAL Atualiza a Azure Active Directory Authentication Library (ADAL) para a Biblioteca de Autenticação da Microsoft (MSAL).
Atualização ASP.NET SignalR Atualiza o ASP.NET SignalR para ASP.NET Core SignalR.
Atualização das interfaces Bond Atualiza a serialização do Microsoft Bond para alternativas modernas.
Atualização do Data EDM para OData Tipos de Data.Edm atualizações para bibliotecas OData.
Atualização de Dados OData para OData Core Upgrades Microsoft.Data.OData para Microsoft.OData.Core.
Atualização do cliente de Serviços de Dados Atualiza o cliente WCF Data Services para o cliente OData moderno.
Atualização do SDK PowerShell Atualiza os módulos PowerShell de Windows PowerShell 5.1 para PowerShell 7+ com o pacote Microsoft.PowerShell.SDK.
Atualização dos Serviços SPA para Proxy SPA Atualizações Microsoft.AspNetCore.SpaServices para o modelo de alojamento SPA Proxy.
Sistema de Atualização. Espacial As melhorias Microsoft.Spatial e System.Spatial para alternativas espaciais modernas.
Atualização do WebAPI CORS Upgrades System.Web.Http.Cors para ASP.NET Core middleware CORS.
Atualização da WebAPI OData Atualiza WebAPI OData para ASP.NET Core OData.

Quando as habilidades são ativadas

O agente carrega competências progressivamente à medida que a sua sessão de melhoria avança:

Quando O que acontece
Início da sessão O agente carrega o cenário correspondente e quaisquer competências que sejam imediatamente relevantes para a tua base de código.
Durante a execução À medida que o agente trabalha em tarefas, carrega competências especializadas adicionais a pedido quando encontra padrões específicos de atualização, como ficheiros EDMX, serviços WCF ou middleware OWIN.
A pedido Pode pedir ao agente para usar qualquer habilidade a qualquer momento. Por exemplo, "ajuda-me a atualizar WCF para CoreWCF" ou "usar a habilidade de atualização do EF6."

Não precisas de gerir a carga de competências. O agente trata disso automaticamente. Basta descrever o que precisa.

Cria as tuas próprias competências

Crie competências personalizadas para ensinar aos agentes padrões específicos da sua base de código, como atualizações internas do framework, convenções de programação ou fluxos de trabalho personalizados de atualização.

Coloca as competências no teu repositório (.github/skills/) ou perfil de utilizador (%UserProfile%/.copilot/skills/), e o agente recolhe-as automaticamente.

Para mais informações sobre como criar competências personalizadas, consulte Aplicar instruções de atualização personalizadas.

Conteúdo relacionado

  • Last updated on