Forgatókönyvek és készségek referenciája

GitHub Copilot .NET modernizálása segít a scenarios és skills:

  • Scenarios a fő frissítési célokhoz, például a .NET Keretrendszerről .NET 10-re való frissítéshez végpontok közötti felügyelt munkafolyamatok. A forgatókönyvek a teljes életciklust koordinálják: az értékelést, a tervezést és a feladatonkénti végrehajtást.
  • A készségek az adott frissítési feladatokra összpontosított képességek, például az EF6 ef Core-ra való konvertálása vagy a WCF CoreWCF-re való lecserélése. A képességek automatikusan aktiválódnak, amikor az ügynök megfelelő kóddal találkozik a frissítés során.

Az ügynök támogatja a C# és Visual Basic projekteket is.

Jótanács

Nem kell megjegyeznie a neveket. Írja le, hogy mit szeretne ("frissítés .NET 10", "upgrade my EF6 code", "replace Newtonsoft.Json"), és az ügynök automatikusan betölti a megfelelő forgatókönyvet és készségeket. Azt is megkérdezheti: "Miben tudsz segíteni?"

Lehetséges helyzetek

A forgatókönyvek az ügynök legfelső szintű frissítési munkafolyamatai. Amikor elindít egy beszélgetést, az ügynök azonosítja a cél legjobb forgatókönyvét, és lépésről lépésre végigvezeti rajta.

Scenario Mire szolgál? Példakérés
.NET verziófrissítés Frissíti a projekteket bármely régebbi .NET verzióról a 8-.NET vagy újabb verzióra. "A megoldás frissítése 10"
SDK-stílusú átalakítás Az örökölt projektfájlokat modern SDK-stílusú formátummá alakítja. "Projektjeim átalakítása SDK-stílusúvá"
Newtonsoft.Json frissítés A Newtonsoft.Json helyett a System.Text.Json lesz a megoldás. "Frissítés a Newtonsoft.Json-ról"
SqlClient-frissítés A System.Data.SqlClient frissítése Microsoft. Data.SqlClient. "Az SqlClient frissítése a modern csomagra"
Azure Functions frissítés A Azure Functions frissítése folyamatban lévőről izolált feldolgozói modellre. "A Azure Functions frissítése"
Szemantikus kernel ügynököknek Frissítés az SK-ügynökökről az Microsoft Ügynök-keretrendszerre. "Az SK-ügynökök frissítése"

A részletes útmutatóért tekintse meg az alapfogalmakat.

verziófrissítés .NET

A leggyakoribb forgatókönyv. Frissíti a projekteket bármely régebbi .NET változatról a legújabbra:

Forrás Target
.NET Keretrendszer (bármely verzió) 8-.NET vagy újabb
.NET Core 1.x–3.x 8-.NET vagy újabb
.NET 5 vagy újabb 8-.NET vagy újabb

Az ügynök elemzi a függőségi gráfot, ellenőrzi a NuGet kompatibilitását, azonosítja a kompatibilitástörő változásokat, és létrehoz egy feladattervet a megoldás legjobb stratégiájával (alulról felfelé, felülről lefelé vagy egyszerre). Ha a projekteknek formátumkonverzióra van szükségük, az ügynök automatikusan kezeli őket a frissítés részeként.

SDK-stílusú átalakítás

Az örökölt .csproj és .vbproj a fájlokat modern SDK-stílusú formátummá alakítja a cél-keretrendszerek módosítása nélkül. Az ügynök automatikusan kezeli az átalakítást a verziófrissítések során. Szükség esetén külön futtassa ezt a forgatókönyvet.

Newtonsoft.Json frissítés

Lecseréli Newtonsoft.Json a teljes megoldásra System.Text.Json . Kezeli az egyéni konvertereket, [JsonProperty] attribútumokat, JObject/JArray használati és szerializálási beállításokat.

SqlClient-frissítés

A System.Data.SqlClient verzióról Microsoft.Data.SqlClient verzióra frissít. Kezeli a Encrypt=true alapértelmezett viselkedésváltozást és kapcsolati karakterlánc különbségeket.

Azure Functions frissítés

Frissíti a Azure Functions a folyamatban lévő üzemeltetési modellről az elkülönített feldolgozói modellre a Program.cs és HostApplicationBuilder használatával. Tartalmazza az Application Insights frissítését.

Szemantikus kernel az Ügynök-keretrendszer Microsoft

Frissítés Szemantikus kernel ügynökökről (ChatCompletionAgent, OpenAIAssistantAgent) Microsoft Ügynök-keretrendszerre. Frissíti a csomagokat és az API-mintákat.

Készségfejlesztés: gyakori

A projekttípusokra vonatkozó általános célú frissítési készségek.

Készség Mire szolgál?
Konvertálás SDK-stílusra Az örökölt projektfájlokat modern SDK-stílusú formátummá alakítja. Topológiai rendezést használ többprojektes megoldásokhoz.
A Di Teljesen eltávolítja az Autofac-ot, és az összes regisztrációt beépített ASP.NET Core függőséginjektálásra frissíti.
Az Autofac .NET Megtartja az Autofac-ot di-tárolóként, de modernizálja ASP.NET Core integrációját.
Titkosítási névterek frissítése Kijavítja a névtér felosztását a System.Security.Cryptography hasonló és X509Certificate2a .SignedCms
A Newtonsoft frissítése System.Text.Json-ra Teljes frissítés innen Newtonsoft.Json: . Konvertereket, attribútumokat, dinamikus típusokat és beállításokat kezel.
A Szemantikus kernel felminősítése ügynököknek Frissíti Szemantikus kernel ügynök API-kat az Microsoft Agent AI-keretrendszerre.
Frissítés MSMQ-ra. Üzenet A System.Messaging (csak .NET-keretrendszer) verzióról MSMQ.Messaging verzióra frissít a .NET Core-hoz.
Átalakítás központi csomagkezelésre Projektenkénti NuGet-csomagverziót alakít át központosított csomagkezeléssé a használatával Directory.Packages.props.
A C#-verzió modernizálása A C#-kód frissítése újabb nyelvi funkciók használatára (C# 7.0–15). A mechanikai változásokat dotnet format az LLM-ítélet alapján köti le szemantikai átalakításokhoz.
C# null értékű hivatkozások frissítése Engedélyezi a null értékű hivatkozástípusokat, és szisztematikusan feloldja az összes CS86xx-figyelmeztetést. Ismerteti a bevezetési stratégiákat, a széljegyzetekkel kapcsolatos útmutatást és a keretrendszerspecifikus szempontokat.

Képességfejlesztés: adathozzáférés

Az adatelérési rétegek, köztük az Entity Framework, a LINQ sql-re és az SQL-ügyfélkódtárak frissítésére vonatkozó ismeretek.

Készség Mire szolgál?
Az EDMX frissítése a Code-Firstre Az EF6-Database-First (.edmx) modelleket az EF Core Code-Firstre konvertálja. Az adatbázisból származó entitások állványzatai.
EF DbContext frissítése Regisztrálja DbContext ASP.NET Core függőséginjektálásban. Kezeli az EF6-ot az EF Core-ra és a meglévő EF Core-mintákat is.
EF6-Code-First frissítése EF Core-ra Frissíti az EF6 Code-First EF Core-ra. Felcseréli a csomagokat, frissíti a névtereket, és lecseréli EntityTypeConfiguration és DbModelBuilder.
A Microsoft. Data.SqlClient Frissítések innen System.Data.SqlClient: . Kezeli a Encrypt=true alapértelmezett módosítást és kapcsolati karakterlánc különbségeket.

Készségfejlesztés: webes és ASP.NET

Készségek ASP.NET keretrendszeralkalmazások ASP.NET Core való frissítéséhez.

ASP.NET keretrendszer frissítése

Készség Mire szolgál?
A ASP.NET-keretrendszer alapszintűre való felminősítése Átfogó frissítés ASP.NET Keretrendszerről (MVC/WebAPI) ASP.NET Core, beleértve a vezérlőket, nézeteket, köztes szoftvereket, hitelesítést és konfigurációt.
A ASP.NET Identitás Frissíti ASP.NET, MVC identitást ASP.NET Core identitásra, beleértve a IdentityDbContext, UserManager, SignInManager és auth köztes szoftvereket.
A Global.asax frissítése A Global.asax életciklus-eseményeket (Application_Start, Application_Error) ASP.NET Core Program.cs és köztes szoftversé alakítja.
OWIN frissítése köztes szoftverre Az OWIN/Katana köztes szoftver (IAppBuilder, OwinMiddleware) helyére ASP.NET Core egyenértékek lépnek.
OWIN cookie-hitelesítés frissítése Frissíti az OWIN cookie-hitelesítési köztes szoftverét a cookie-hitelesítés ASP.NET Core.
OWIN OAuth frissítése JWT-re Frissíti az OWIN OAuth-tulajdonosi jogkivonat-hitelesítést a JWT-tulajdonos hitelesítésének ASP.NET Core.
Az OWIN OpenID Connect frissítése Frissíti az OWIN OpenID Connect köztes szoftverét az OpenID Connect-hitelesítés ASP.NET Core.

MVC-funkciók

Készség Mire szolgál?
MVC-hitelesítés frissítése Frissíti ASP.NET, MVC hitelesítést ASP.NET Core identitás- és hitelesítési köztes szoftverre.
MVC-csomagküldő szolgáltatás frissítése A kötegelést System.Web.Optimization közvetlen <script>/<link> címkékké vagy modern kötegelőkké alakítja.
MVC-konfiguráció frissítése Frissíti web.config és app.config beállításait a ASP.NET Core konfigurációs rendszerre (appsettings.json, környezeti változók).
MVC-tartalom egyeztetésének frissítése Frissíti a tartalomegyeztetési mintákat és a formázókat a ASP.NET Core.
MVC-vezérlők frissítése MVC- és WebAPI-vezérlőket frissít ASP.NET Core vezérlőmintákra.
MVC függőséginjektálás frissítése Frissíti a di-tárolóregisztrációkat ASP.NET Core beépített függőséginjektálására.
MVC-szűrők frissítése Globális MVC-szűrőket (FilterConfig, GlobalFilters) konvertál ASP.NET Core köztes szoftverré és szűrőfolyamattá.
MVC HTTP-folyamat frissítése HTTP-modulokat és kezelőket frissít ASP.NET Core köztes szoftverre.
Az MVC HttpContext frissítése Frissíti a System.Web.HttpContext használatot ASP.NET Core HttpContext.
MVC-naplózás frissítése Frissíti a naplózást a Microsoft.Extensions.Logging.
MVC-modell kötésének frissítése Frissíti a modellkötési mintákat ASP.NET Core modellkötésre.
MVC Razor-nézetek frissítése Razor-nézetek, elrendezések és nézetösszetevők frissítése a Razor ASP.NET Core.
MVC-útválasztás frissítése A RouteCollection útválasztást ASP.NET Core végponti útválasztássá alakítja át (MapControllerRoute, attribútum-útválasztás).
MVC-munkamenet állapotának frissítése Frissíti a munkamenet állapotát ASP.NET Core elosztott munkamenetre.
MVC statikus fájlok frissítése Frissíti a statikus fájlkezelést ASP.NET Core statikus fájlközvetítő szoftverére.
MVC System.Web-adapterek frissítése System.Web-adaptereket használ a ASP.NET-keretrendszerről a ASP.NET Core való növekményes frissítéshez.
MVC-ellenőrzés frissítése Frissíti az érvényesítési attribútumokat és a mintákat ASP.NET Core érvényesítésre.

WCF

Készség Mire szolgál?
WCF frissítése CoreWCF-re A kiszolgálóoldali WCF-szolgáltatásokat CoreWCF .NET 6+-ra frissíti. Alakítja át az üzemeltetési, kötési, viselkedési bővítményeket és aszinkron szerződéseket.

Készségek fejlesztése: felhő és Azure

Készség Mire szolgál?
A Azure Functions indítása Frissíti a Azure Functions a folyamatban lévő Startup osztályról a Program.cs rendelkező izolált feldolgozói modellre.
A Azure Functions 2 A IHostApplicationBuilder használatával frissíti Azure Functions a v2-üzemeltetési mintára.
Felminősítési Azure Key Vault Frissíti az örökölt Azure Key Vault SDK-t a modern Azure.Security.KeyVault kódtárakra.
Felminősítési Azure Service Bus Frissíti az örökölt Azure Service Bus SDK-t a modern Azure.Messaging.ServiceBus könyvtárra.
Azure Storage Frissíti az örökölt Azure Storage SDK-t a modern Azure.Storage kódtárakra.

Készségfejlesztés: kódtárak

Készség Mire szolgál?
Az ADAL frissítése MSAL-re Frissíti Azure Active Directory hitelesítési kódtárat (ADAL) Microsoft Authentication Library (MSAL) értékre.
Felminősítés ASP.NET SignalR Frissíti ASP.NET SignalR-t ASP.NET Core SignalR-re.
Bond-interfészek frissítése Modern alternatívákra frissíti Microsoft Bond szerializálását.
Data EDM frissítése OData-ra OData-kódtárakra Data.Edm frissíti a típusokat.
Data OData frissítése OData Core-ra Frissíti a Microsoft.Data.ODataMicrosoft.OData.Core.
Data Services-ügyfél frissítése Frissíti a WCF Data Services-ügyfelet a modern OData-ügyfélre.
A PowerShell SDK frissítése A PowerShell-modulokat Windows PowerShell 5.1-ről PowerShell 7+-ra frissíti a Microsoft.PowerShell.SDK csomaggal.
SPA-szolgáltatások frissítése SPA-proxyra Frissíti Microsoft.AspNetCore.SpaServices az SPA proxy üzemeltetési modellre.
System.Spatial frissítése Frissíti Microsoft.Spatial és System.Spatial modern térbeli alternatívákra.
A WebAPI CORS frissítése Frissíti System.Web.Http.Cors ASP.NET Core CORS köztes szoftverre.
WebAPI OData frissítése Frissíti a WebAPI OData-t ASP.NET Core OData-ra.

Amikor a készségek aktiválódnak

Az ügynök fokozatosan betölti a készségeket a frissítési munkamenet kibontakozása során:

Mikor Mi történik?
Munkamenet kezdete Az ügynök betölti az egyező forgatókönyvet és minden olyan készséget, amely azonnal releváns a kódbázishoz.
Végrehajtás során Mivel az ügynök feladatokat végez, igény szerint további speciális készségeket tölt be, amikor bizonyos frissítési mintákkal találkozik, például EDMX-fájlokkal, WCF-szolgáltatásokkal vagy OWIN köztes szoftverekkel.
Kérésre Bármikor megkérheti az ügynököt, hogy bármilyen képességet használjon. Például : "Segítsen a WCF CoreWCF-re való frissítésében" vagy "használja az EF6 frissítési készséget".

Nem kell kezelnie a képességbetöltést. Az ügynök automatikusan kezeli. Csak írja le, hogy mire van szüksége.

Saját készségek létrehozása

Egyéni készségeket hozhat létre a kódbázisra jellemző ügynökminták, például belső keretrendszerfrissítések, kódolási konvenciók vagy egyéni frissítési munkafolyamatok tanításához.

Helyezze a készségeket az adattárba (.github/skills/) vagy a felhasználói profilba (%UserProfile%/.copilot/skills/), és az ügynök automatikusan felveszi őket.

Az egyéni készségek létrehozásával kapcsolatos további információkért lásd: Egyéni frissítési utasítások alkalmazása.