Dokumentacja scenariuszy i umiejętności

GitHub Copilot modernizacja .NET ułatwia modernizację scenarios i lls:

  • Scenarios to kompleksowe zarządzane przepływy pracy na potrzeby głównych celów uaktualniania, takich jak uaktualnianie z programu .NET Framework do .NET 10. Scenariusze koordynują pełny cykl życia: ocena, planowanie i wykonywanie zadań według zadań.
  • Umiejętności koncentrują się na możliwościach określonych zadań uaktualniania, takich jak konwertowanie programu EF6 na program EF Core lub zastępowanie programu WCF za pomocą platformy CoreWCF. Umiejętności są aktywowane automatycznie, gdy agent napotka odpowiedni kod podczas uaktualniania.

Agent obsługuje projekty w języku C# i Visual Basic.

Napiwek

Nie musisz zapamiętywać nazw. Opisz, co chcesz ("uaktualnianie do wersji .NET 10", "uaktualnij kod EF6", "zastąp plik Newtonsoft.Json"), a agent automatycznie ładuje odpowiedni scenariusz i umiejętności. Możesz również zapytać: "Z czym mogę mi pomóc?"

Scenariusze

Scenariusze to przepływy pracy uaktualniania najwyższego poziomu agenta. Po rozpoczęciu konwersacji agent identyfikuje najlepszy scenariusz dla twojego celu i przeprowadzi Cię przez niego krok po kroku.

Scenario Do czego służy Przykładowy monit
.NET Uaktualnia projekty ze starszej wersji .NET do wersji .NET 8 lub nowszej. "Uaktualnij moje rozwiązanie, aby .NET 10"
Konwersja w stylu zestawu SDK Konwertuje starsze pliki projektów na nowoczesny format w stylu zestawu SDK. "Konwertowanie moich projektów na styl zestawu SDK"
Uaktualnianie pliku Newtonsoft.Json Zastępuje plik Newtonsoft.Json plikiem System.Text.Json w rozwiązaniu. "Uaktualnianie z pliku Newtonsoft.Json"
Uaktualnienie klienta SqlClient Uaktualnia element System.Data.SqlClient do Microsoft. Data.SqlClient. "Zaktualizuj klienta SqlClient do nowoczesnego pakietu"
Azure Functions upgrade Uaktualnia Azure Functions z procesu do izolowanego modelu procesu roboczego. "Uaktualnij moją Azure Functions"
Semantic Kernel do agentów Uaktualnia agentów SK do programu Microsoft Agent Framework. "Uaktualnij agentów SK"

Aby zapoznać się z kompleksowego przewodnika, zobacz Podstawowe pojęcia.

.NET uaktualnianie wersji

Najbardziej typowy scenariusz. Uaktualnia projekty ze starszego wariantu .NET do najnowszego:

Źródło Obiekt docelowy
.NET Framework (dowolna wersja) .NET 8 lub nowszych
.NET Core 1.x–3.x .NET 8 lub nowszych
.NET 5 lub nowszych .NET 8 lub nowszych

Agent analizuje graf zależności, sprawdza zgodność rozwiązania NuGet, identyfikuje zmiany powodujące niezgodność i tworzy plan zadań przy użyciu najlepszej strategii rozwiązania (od dołu do góry, od góry do góry lub od razu). Jeśli projekty wymagają konwersji formatu, agent automatycznie obsługuje je w ramach uaktualnienia.

Konwersja w stylu zestawu SDK

Konwertuje starsze wersje .csproj i .vbproj pliki na nowoczesny format w stylu zestawu SDK bez zmieniania platform docelowych. Agent automatycznie obsługuje konwersję podczas uaktualniania wersji. W razie potrzeby uruchom ten scenariusz niezależnie.

Uaktualnianie pliku Newtonsoft.Json

Newtonsoft.Json Zastępuje ciąg ciągiem System.Text.Json w całym rozwiązaniu. Obsługuje niestandardowe konwertery, [JsonProperty] atrybuty, JObject/JArray użycie i ustawienia serializacji.

Uaktualnienie klienta SqlClient

Uaktualnienia z System.Data.SqlClient do Microsoft.Data.SqlClient. Obsługuje zmianę zachowania domyślnego Encrypt=true i różnice parametry połączenia.

uaktualnianie Azure Functions

Uaktualnia Azure Functions z modelu hostingu procesowego do izolowanego modelu roboczego z Program.cs i HostApplicationBuilder. Obejmuje uaktualnienie usługi Application Insights.

Semantic Kernel do platformy agentów Microsoft

Uaktualnienia z agentów Semantic Kernel (ChatCompletionAgent, OpenAIAssistantAgent) do Microsoft Agent Framework. Aktualizuje pakiety i wzorce interfejsu API.

Umiejętności uaktualniania: typowe

Umiejętności uaktualniania ogólnego przeznaczenia, które mają zastosowanie w różnych typach projektów.

Umiejętność Do czego służy
Konwertowanie na styl zestawu SDK Konwertuje starsze pliki projektów na nowoczesny format w stylu zestawu SDK. Używa kolejności topologicznej dla rozwiązań wieloprojektowych.
Ufanie autofak do .NET DI Całkowicie usuwa funkcję Autofac i uaktualnia wszystkie rejestracje do wbudowanych ASP.NET Core wstrzykiwania zależności.
Integrating Autofac with .NET Zachowuje funkcję Autofac jako kontener DI, ale modernizuje swoją integrację ASP.NET Core.
Uaktualnianie przestrzeni nazw kryptograficznych System.Security.Cryptography Naprawia podział przestrzeni nazw dla typów takich jak X509Certificate2 i SignedCms.
Uaktualnianie pakietu Newtonsoft do pliku System.Text.Json Pełne uaktualnienie z programu Newtonsoft.Json. Obsługuje konwertery, atrybuty, typy dynamiczne i ustawienia.
Wygodanie Semantic Kernel do agentów Uaktualnia interfejsy API agenta Semantic Kernel do struktury AI agentów Microsoft.
Uaktualnianie do usługi MSMQ. Wiadomości Uaktualnienia z System.Messaging (tylko .NET Framework) do MSMQ.Messaging dla .NET Core.
Konwertowanie na centralne zarządzanie pakietami Konwertuje wersje pakietów NuGet dla projektu na scentralizowane zarządzanie pakietami przy użyciu polecenia Directory.Packages.props.
Modernizowanie wersji języka C# Uaktualnia kod języka C#, aby używać nowszych funkcji języka (C# 7.0 do 15). Wsaduje zmiany mechaniczne przez dotnet format i używa oceny LLM dla przekształceń semantycznych.
Uaktualnianie odwołań dopuszczanych do wartości null w języku C# Włącza typy odwołań dopuszczające wartości null i systematycznie rozwiązuje wszystkie ostrzeżenia CS86xx. Obejmuje strategie wdrażania, wskazówki dotyczące adnotacji i zagadnienia specyficzne dla platformy.

Umiejętności uaktualniania: dostęp do danych

Umiejętności dotyczące uaktualniania warstw dostępu do danych, w tym platformy Entity Framework, LINQ to SQL i bibliotek klienckich SQL.

Umiejętność Do czego służy
Uaktualnianie programu EDMX do funkcji Code-First Konwertuje modele EF6 Database-First (.edmx) na program EF Core Code-First. Tworzenie szkieletów jednostek z bazy danych.
Uaktualnianie programu EF DbContext Rejestruje DbContext iniekcji zależności ASP.NET Core. Obsługuje zarówno program EF6, jak i istniejące wzorce ef core.
Uaktualnianie Code-First EF6 do programu EF Core Uaktualnia Code-First EF6 do platformy EF Core. Zamienia pakiety, aktualizuje przestrzenie nazw i zastępuje EntityTypeConfiguration wartości i DbModelBuilder.
Ugradowanie do Microsoft. Data.SqlClient Uaktualnienia z programu System.Data.SqlClient. Obsługuje domyślną zmianę Encrypt=true i parametry połączenia różnice.

Umiejętności uaktualniania: sieć Web i ASP.NET

Umiejętności dotyczące uaktualniania aplikacji platformy ASP.NET Framework do ASP.NET Core.

uaktualnianie platformy ASP.NET

Umiejętność Do czego służy
Upgrading ASP.NET Framework do platformy Core Kompleksowe uaktualnianie z ASP.NET Framework (MVC/WebAPI) do ASP.NET Core, w tym kontrolerów, widoków, oprogramowania pośredniczącego, uwierzytelniania i konfiguracji.
Upgrading ASP.NET Identity Uaktualnia ASP.NET MVC Identity do ASP.NET Core Identity, w tym IdentityDbContext, UserManager, SignInManager i oprogramowanie pośredniczące uwierzytelniania.
Uaktualnianie pliku Global.asax Konwertuje zdarzenia cyklu życia Global.asax (Application_Start, Application_Error) na ASP.NET Core Program.cs i oprogramowanie pośredniczące.
Uaktualnianie OWIN do oprogramowania pośredniczącego Zastępuje oprogramowanie pośredniczące OWIN/Katana (IAppBuilder, OwinMiddleware) odpowiednikami ASP.NET Core.
Uaktualnianie uwierzytelniania plików cookie OWIN Uaktualnia oprogramowanie pośredniczące uwierzytelniania plików cookie OWIN w celu ASP.NET Core uwierzytelniania plików cookie.
Uaktualnianie protokołu OAuth OWIN do JWT Uaktualnia uwierzytelnianie tokenu elementu nośnego OWIN OAuth w celu ASP.NET Core uwierzytelniania elementu nośnego JWT.
Uaktualnianie protokołu OWIN OpenID Connect Uaktualnia oprogramowanie pośredniczące OWIN OpenID Connect w celu ASP.NET Core uwierzytelniania OpenID Connect.

Funkcje MVC

Umiejętność Do czego służy
Uaktualnianie uwierzytelniania MVC Uaktualnia uwierzytelnianie ASP.NET MVC do oprogramowania pośredniczącego ASP.NET Core Identity and authentication.
Uaktualnianie pakietu MVC Konwertuje System.Web.Optimization grupowanie na tagi bezpośrednie <script>/<link> lub nowoczesne pakiety.
Uaktualnianie konfiguracji MVC Uaktualnia ustawienia web.config i app.config do systemu konfiguracji ASP.NET Core (appsettings.json, zmienne środowiskowe).
Uaktualnianie negocjacji zawartości MVC Uaktualnia wzorce negocjacji zawartości i formatery do ASP.NET Core.
Uaktualnianie kontrolerów MVC Uaktualnia kontrolery MVC i WebAPI do ASP.NET Core wzorców kontrolera.
Uaktualnianie wstrzykiwania zależności MVC Uaktualnia rejestracje kontenerów DI do wbudowanej iniekcji zależności ASP.NET Core.
Uaktualnianie filtrów MVC Konwertuje globalne filtry MVC (FilterConfig, GlobalFilters) na potok oprogramowania pośredniczącego i filtru ASP.NET Core.
Uaktualnianie potoku HTTP MVC Uaktualnia moduły HTTP i programy obsługi w celu ASP.NET Core oprogramowania pośredniczącego.
Uaktualnianie obiektu HTTPContext MVC Uaktualnia System.Web.HttpContext użycie do ASP.NET Core HttpContext.
Uaktualnianie rejestrowania MVC Uaktualnia rejestrowanie do Microsoft.Extensions.Logging.
Uaktualnianie powiązania modelu MVC Uaktualnia wzorce powiązań modelu do powiązania modelu ASP.NET Core.
Uaktualnianie widoków MVC Razor Uaktualnia widoki Razor, układy i składniki widoku, aby ASP.NET Core Razor.
Uaktualnianie routingu MVC Konwertuje routing RouteCollection na routing punktu końcowego ASP.NET Core (MapControllerRoute, routing atrybutów).
Uaktualnianie stanu sesji MVC Uaktualnia stan sesji do ASP.NET Core sesji rozproszonej.
Uaktualnianie plików statycznych MVC Uaktualnia obsługę plików statycznych do oprogramowania pośredniczącego plików statycznych ASP.NET Core.
Uaktualnianie kart MVC System.Web Używa kart System.Web do uaktualniania przyrostowego z platformy ASP.NET Framework do ASP.NET Core.
Uaktualnianie weryfikacji wzorca MVC Uaktualnia atrybuty weryfikacji i wzorce w celu ASP.NET Core weryfikacji.

WCF

Umiejętność Do czego służy
Uaktualnianie programu WCF do programu CoreWCF Uaktualnia usługi WCF po stronie serwera do CoreWCF dla .NET 6 lub nowszych. Konwertuje hosting, powiązania, rozszerzenia zachowania i kontrakty asynchroniczne.

Umiejętności uaktualniania: chmura i Azure

Umiejętność Do czego służy
Upgrading Azure Functions Startup Uaktualnia Azure Functions z klasy Startup do izolowanego modelu roboczego z Program.cs.
Upgrading Azure Functions do wersji 2 Uaktualnia Azure Functions do wzorca hostingu w wersji 2 przy użyciu IHostApplicationBuilder.
Upgrading Azure Key Vault Uaktualnia starsze zestawy SDK Azure Key Vault do nowoczesnych bibliotek Azure.Security.KeyVault.
Upgrading Azure Service Bus Uaktualnia starszy zestaw SDK Azure Service Bus do nowoczesnej biblioteki Azure.Messaging.ServiceBus.
Upgrading Azure Storage Uaktualnia starszy zestaw SDK Azure Storage do nowoczesnych bibliotek Azure.Storage.

Umiejętności uaktualniania: biblioteki

Umiejętność Do czego służy
Uaktualnianie biblioteki ADAL do biblioteki MSAL Uaktualnia bibliotekę Azure Active Directory Authentication Library (ADAL) do biblioteki Microsoft Authentication Library (MSAL).
Upgrading ASP.NET SignalR Uaktualnia ASP.NET SignalR do ASP.NET Core SignalR.
Uaktualnianie interfejsów obligacji Uaktualnienia Microsoft serializacji Bond do nowoczesnych alternatyw.
Uaktualnianie danych EDM do OData Uaktualnia Data.Edm typy do bibliotek OData.
Uaktualnianie danych OData do OData Core Uaktualnia Microsoft.Data.OData do Microsoft.OData.Core.
Uaktualnianie klienta usług danych Uaktualnia klienta usług danych WCF do nowoczesnego klienta OData.
Uaktualnianie zestawu POWERShell SDK Uaktualnia moduły programu PowerShell z programu Windows PowerShell 5.1 do programu PowerShell 7+ przy użyciu pakietu Microsoft.PowerShell.SDK.
Uaktualnianie usług SPA do serwera proxy SPA Uaktualnia Microsoft.AspNetCore.SpaServices do modelu hostingu serwera proxy SPA.
Uaktualnianie elementu System.Spatial Uaktualnienia Microsoft.Spatial i System.Spatial do nowoczesnych alternatyw przestrzennych.
Uaktualnianie mechanizmu CORS interfejsu WebAPI Uaktualnienia System.Web.Http.Cors do ASP.NET Core oprogramowania pośredniczącego CORS.
Uaktualnianie protokołu OData interfejsu WebAPI Uaktualnia webAPI OData do ASP.NET Core OData.

Po aktywowaniu umiejętności

Agent ładuje umiejętności stopniowo w miarę rozwoju sesji uaktualniania:

Kiedy Co się stanie
Rozpoczęcie sesji Agent ładuje pasujący scenariusz i wszelkie umiejętności, które są natychmiast istotne dla bazy kodu.
Podczas wykonywania Ponieważ agent pracuje za pomocą zadań, ładuje dodatkowe wyspecjalizowane umiejętności na żądanie, gdy napotka określone wzorce uaktualniania, takie jak pliki EDMX, usługi WCF lub oprogramowanie pośredniczące OWIN.
Na żądanie W dowolnym momencie możesz poprosić agenta o użycie dowolnej umiejętności. Na przykład "pomóż mi uaktualnić program WCF do coreWCF" lub "użyć umiejętności uaktualniania EF6".

Nie musisz zarządzać ładowaniem umiejętności. Agent automatycznie go obsługuje. Wystarczy opisać to, czego potrzebujesz.

Tworzenie własnych umiejętności

Tworzenie niestandardowych umiejętności uczenia wzorców agentów specyficznych dla bazy kodu, takich jak wewnętrzne uaktualnienia struktur, konwencje kodowania lub niestandardowe przepływy pracy uaktualniania.

Umieść umiejętności w repozytorium (.github/skills/) lub profilu użytkownika (%UserProfile%/.copilot/skills/), a agent automatycznie je pobiera.

Aby uzyskać więcej informacji na temat tworzenia umiejętności niestandardowych, zobacz Stosowanie niestandardowych instrukcji uaktualniania.

Treści powiązane

  • Last updated on