Escenarios y referencia de aptitudes

GitHub Copilot modernización para .NET le ayuda a modernizar a través de scenarios y skills:

  • Scenarios son flujos de trabajo administrados de un extremo a otro para los principales objetivos de actualización, como la actualización de .NET Framework a .NET 10. Los escenarios coordinan el ciclo de vida completo: evaluación, planificación y ejecución de tareas por tarea.
  • Las aptitudes son funcionalidades centradas en tareas de actualización específicas, como convertir EF6 en EF Core o reemplazar WCF por CoreWCF. Las aptitudes se activan automáticamente cuando el agente encuentra código relevante durante una actualización.

El agente admite proyectos de C# y Visual Basic.

Sugerencia

No es necesario memorizar nombres. Describir lo que desea ("actualizar a .NET 10", "actualizar mi código EF6", "replace Newtonsoft.Json") y el agente carga automáticamente el escenario y las aptitudes adecuados. También puede preguntar: "¿Con qué puede ayudarme?"

Escenarios

Los escenarios son los flujos de trabajo de actualización de nivel superior del agente. Al iniciar una conversación, el agente identifica el mejor escenario para su objetivo y lo guía paso a paso.

Escenario Qué hace Mensaje de ejemplo
.NET actualización de la versión Actualiza los proyectos de cualquier versión de .NET anterior a .NET 8 o posterior. "Actualizar mi solución a .NET 10"
Conversión de estilo SDK Convierte los archivos de proyecto heredados en formato moderno de estilo SDK. "Convertir mis proyectos en estilo SDK"
Actualización de Newtonsoft.Json Reemplaza Newtonsoft.Json por System.Text.Json en una solución. "Actualizar desde Newtonsoft.Json"
Actualización de SqlClient Actualiza System.Data.SqlClient a Microsoft. Data.SqlClient. "Actualizar SqlClient al paquete moderno"
Azure Functions upgrade Actualiza Azure Functions del modelo de trabajo aislado en proceso. "Actualizar mi Azure Functions"
Kernel semántico a Agents Actualiza de agentes de SK a Microsoft Agent Framework. "Actualizar mis agentes de SK"

Para ver un tutorial completo, consulte Conceptos básicos.

actualización de la versión de .NET

El escenario más común. Actualiza los proyectos desde cualquier variante de .NET anterior a la más reciente:

Fuente Objetivo
.NET Framework (cualquier versión) .NET 8 o posterior
.NET Core 1.x–3.x .NET 8 o posterior
.NET 5 o posterior .NET 8 o posterior

El agente analiza el gráfico de dependencias, comprueba la compatibilidad de NuGet, identifica los cambios importantes y crea un plan de tareas con la mejor estrategia para la solución (de arriba abajo, arriba arriba o todo a la vez). Si los proyectos necesitan conversiones de formato, el agente las controla automáticamente como parte de la actualización.

Conversión de estilo SDK

Convierte los archivos y .csproj heredados .vbproj en el formato moderno de estilo SDK sin cambiar las plataformas de destino. El agente controla la conversión automáticamente durante las actualizaciones de versiones. Ejecute este escenario de forma independiente si es necesario.

Actualización de Newtonsoft.Json

Newtonsoft.Json Reemplaza por System.Text.Json en toda la solución. Controla convertidores personalizados, [JsonProperty] atributos, JObject/JArray uso y configuración de serialización.

Actualización de SqlClient

Actualiza de System.Data.SqlClient a Microsoft.Data.SqlClient. Controla el cambio de comportamiento predeterminado de Encrypt=true y cadena de conexión diferencias.

actualización de Azure Functions

Actualiza Azure Functions desde el modelo de hospedaje en proceso al modelo de trabajo aislado con Program.cs y HostApplicationBuilder. Incluye la actualización de Application Insights.

Kernel semántico a Microsoft Agent Framework

Actualiza desde agentes de Kernel semántico (ChatCompletionAgent, OpenAIAssistantAgent) a Microsoft Agent Framework. Actualiza los paquetes y los patrones de API.

Conocimientos de actualización: común

Aptitudes de actualización de uso general que se aplican en los tipos de proyecto.

Habilidad Qué hace
Conversión al estilo del SDK Convierte los archivos de proyecto heredados en formato moderno de estilo SDK. Usa el orden topológico para las soluciones de varios proyectos.
Upgrading Autofac to .NET DI Quita Autofac por completo y actualiza todos los registros a la inserción de dependencias de ASP.NET Core integrada.
Integrating Autofac con .NET Mantiene Autofac como contenedor de inserción de dependencias, pero moderniza su integración ASP.NET Core.
Actualización de espacios de nombres de criptografía Corrige la división de System.Security.Cryptography espacio de nombres para tipos como X509Certificate2 y SignedCms.
Actualización de Newtonsoft a System.Text.Json Actualización completa desde Newtonsoft.Json. Controla convertidores, atributos, tipos dinámicos y configuraciones.
Upgrading Kernel semántico a Agents Actualiza las API del agente de Kernel semántico a Microsoft Agents AI Framework.
Actualización a MSMQ. Mensajería Actualiza de System.Messaging (solo .NET Framework) a MSMQ.Messaging para .NET Core.
Conversión a Administración central de paquetes Convierte el control de versiones de paquetes NuGet por proyecto en la administración centralizada de paquetes mediante Directory.Packages.props.
Modernización de la versión de C# Actualiza el código de C# para usar características de lenguaje más recientes (C# 7.0 a 15). Realiza lotes de cambios mecánicos a través dotnet format de y usa la sentencia LLM para las transformaciones semánticas.
Actualización de referencias que aceptan valores NULL de C# Habilita los tipos de referencia que aceptan valores NULL y resuelve sistemáticamente todas las advertencias CS86xx. Trata las estrategias de implementación, las instrucciones de anotación y las consideraciones específicas del marco.

Conocimientos de actualización: acceso a datos

Aptitudes para actualizar las capas de acceso a datos, como Entity Framework, LINQ to SQL y bibliotecas cliente de SQL.

Habilidad Qué hace
Actualización de EDMX a Code-First Convierte los modelos Database-First (.edmx) de EF6 en EF Core Code-First. Aplica scaffolding a las entidades de la base de datos.
Actualización de EF DbContext Registra DbContext en ASP.NET Core inserción de dependencias. Controla EF6 a EF Core y los patrones existentes de EF Core.
Actualización de EF6 Code-First a EF Core Actualiza ef6 Code-First a EF Core. Intercambia paquetes, actualiza espacios de nombres y reemplaza EntityTypeConfiguration y DbModelBuilder.
Upgrading a Microsoft. Data.SqlClient Actualiza desde System.Data.SqlClient. Controla el cambio predeterminado de Encrypt=true y cadena de conexión diferencias.

Conocimientos de actualización: web y ASP.NET

Aptitudes para actualizar aplicaciones de ASP.NET Framework a ASP.NET Core.

actualización de ASP.NET Framework

Habilidad Qué hace
Upgrading ASP.NET Framework a Core Actualización completa de ASP.NET Framework (MVC/WebAPI) a ASP.NET Core, incluidos controladores, vistas, middleware, autenticación y configuración.
Upgrading ASP.NET Identity Actualiza ASP.NET MVC Identity a ASP.NET Core Identity, incluidos IdentityDbContext, UserManager, SignInManager y middleware de autenticación.
Actualización de Global.asax Convierte (, ) en ASP.NET Core y middleware.
Actualización de OWIN al middleware Reemplaza el middleware OWIN/Katana (IAppBuilder, OwinMiddleware) por equivalentes de ASP.NET Core.
Actualización de la autenticación de cookies de OWIN Actualiza el middleware de autenticación de cookies de OWIN para ASP.NET Core autenticación de cookies.
Actualización de OWIN OAuth a JWT Actualiza la autenticación del token de portador de OWIN OAuth a ASP.NET Core autenticación de portador JWT.
Actualización de OWIN OpenID Connect Actualiza el middleware de OWIN OpenID Connect a ASP.NET Core autenticación de OpenID Connect.

Características de MVC

Habilidad Qué hace
Actualización de la autenticación de MVC Actualiza ASP.NET MVC la autenticación a ASP.NET Core middleware de identidad y autenticación.
Actualización de la agrupación de MVC Convierte la agrupación en etiquetas directas System.Web.Optimization<script>/<link> o agrupadores modernos.
Actualización de la configuración de MVC Actualiza web.config y app.config configuración al sistema de configuración de ASP.NET Core (appsettings.json, variables de entorno).
Actualización de la negociación de contenido de MVC Actualiza los patrones y formateadores de negociación de contenido a ASP.NET Core.
Actualización de controladores MVC Actualiza los controladores MVC y WebAPI a ASP.NET Core patrones de controlador.
Actualización de la inserción de dependencias de MVC Actualiza los registros de contenedor de di a la inserción de dependencias integrada de ASP.NET Core.
Actualización de filtros MVC Convierte filtros MVC globales (FilterConfig, GlobalFilters) en ASP.NET Core middleware y canalización de filtro.
Actualización de la canalización HTTP de MVC Actualiza los módulos y controladores HTTP para ASP.NET Core middleware.
Actualización de HttpContext de MVC Actualiza System.Web.HttpContext uso a ASP.NET Core HttpContext.
Actualización del registro de MVC Actualiza el registro a Microsoft.Extensions.Logging.
Actualización del enlace de modelos de MVC Actualiza los patrones de enlace de modelos a ASP.NET Core enlace de modelo.
Actualización de vistas de Razor de MVC Actualiza las vistas, los diseños y los componentes de vista de Razor para ASP.NET Core Razor.
Actualización del enrutamiento de MVC Convierte RouteCollection enrutamiento al enrutamiento de puntos de conexión de ASP.NET Core (MapControllerRoute, enrutamiento de atributos).
Actualización del estado de sesión de MVC Actualiza el estado de sesión a ASP.NET Core sesión distribuida.
Actualización de archivos estáticos de MVC Actualiza el control de archivos estáticos al middleware de archivos estáticos de ASP.NET Core.
Actualización de adaptadores System.Web de MVC Usa adaptadores System.Web para la actualización incremental de ASP.NET Framework a ASP.NET Core.
Actualización de la validación de MVC Actualiza los atributos y patrones de validación para ASP.NET Core validación.

WCF

Habilidad Qué hace
Actualización de WCF a CoreWCF Actualiza los servicios WCF del lado servidor a CoreWCF para .NET 6+. Convierte el hospedaje, los enlaces, las extensiones de comportamiento y los contratos asincrónicos.

Conocimientos de actualización: nube y Azure

Habilidad Qué hace
Upgrading Azure Functions Startup Actualiza Azure Functions de la clase Startup en proceso al modelo de trabajo aislado con Program.cs.
Upgrading Azure Functions a v2 Actualiza Azure Functions al patrón de hospedaje v2 mediante IHostApplicationBuilder.
Upgrading Azure Key Vault Actualiza el SDK de Azure Key Vault heredado a las bibliotecas modernas de Azure.Security.KeyVault.
Upgrading Azure Service Bus Actualiza el SDK de Azure Service Bus heredado a la biblioteca moderna de Azure.Messaging.ServiceBus.
Upgrading Azure Storage Actualiza el SDK de Azure Storage heredado a las bibliotecas modernas de Azure.Storage.

Conocimientos de actualización: bibliotecas

Habilidad Qué hace
Actualización de ADAL a MSAL Actualiza Azure Active Directory biblioteca de autenticación (ADAL) a Biblioteca de autenticación de Microsoft (MSAL).
Upgrading ASP.NET SignalR Actualiza ASP.NET SignalR a ASP.NET Core SignalR.
Actualización de interfaces bond Actualiza Microsoft serialización de Bond a alternativas modernas.
Actualización de Data EDM a OData Actualiza los Data.Edm tipos a las bibliotecas de OData.
Actualización de datos OData a OData Core Actualiza Microsoft.Data.OData a Microsoft.OData.Core.
Actualización del cliente de Data Services Actualiza el cliente de WCF Data Services al cliente de OData moderno.
Actualización del SDK de PowerShell Actualiza los módulos de PowerShell de Windows PowerShell 5.1 a PowerShell 7+ con el paquete Microsoft.PowerShell.SDK.
Actualización de los servicios SPA al proxy DE SPA Actualiza Microsoft.AspNetCore.SpaServices al modelo de hospedaje del proxy spa.
Actualización de System.Spatial Actualiza Microsoft.Spatial y System.Spatial a alternativas espaciales modernas.
Actualización de CORS de WebAPI Actualiza System.Web.Http.Cors a ASP.NET Core middleware de CORS.
Actualización de WebAPI OData Actualiza WebAPI OData a ASP.NET Core OData.

Cuándo se activan las aptitudes

El agente carga las aptitudes progresivamente a medida que se desarrolla la sesión de actualización:

Cuando ¿Qué ocurre?
Inicio de sesión El agente carga el escenario coincidente y todas las aptitudes que sean inmediatamente relevantes para el código base.
Durante la ejecución A medida que el agente trabaja a través de tareas, carga aptitudes adicionales especializadas a petición cuando encuentra patrones de actualización específicos, como archivos EDMX, servicios WCF o middleware de OWIN.
A petición Puede pedir al agente que use cualquier aptitud en cualquier momento. Por ejemplo, "ayudarme a actualizar WCF a CoreWCF" o "usar la aptitud de actualización de EF6".

No es necesario administrar la carga de aptitudes. El agente lo controla automáticamente. Simplemente describa lo que necesita.

Crear sus propias aptitudes

Cree aptitudes personalizadas para enseñar los patrones de agente específicos de su código base, como las actualizaciones internas del marco, las convenciones de codificación o los flujos de trabajo de actualización personalizados.

Coloque las aptitudes en el repositorio (.github/skills/) o el perfil de usuario (%UserProfile%/.copilot/skills/) y el agente los recoge automáticamente.

Para obtener más información sobre cómo crear aptitudes personalizadas, consulte Aplicar instrucciones de actualización personalizadas.

Contenido relacionado

  • Last updated on