dotnet-aspnet

مجموعه مهارت‌های ساخت API، مهاجرت Blazor، آپلود فایل و Observability در ASP.NET Core

این bundle چهار مهارت کاربردی برای توسعه و نگه‌داری برنامه‌های ASP.NET Core ارائه می‌دهد: ساخت Web API با HTTP semantics درست، OpenAPI و مدیریت خطا؛ تبدیل Blazor Server قدیمی به Blazor Web App در .NET 8+؛ پیاده‌سازی آپلود فایل در Minimal API؛ و تنظیم OpenTelemetry برای tracing، metrics و logging.

با این مجموعه، Agent می‌تواند در سناریوهای رایج backend راهنمایی عملی و تغییرات کدی دقیق ارائه دهد و انتخاب الگوهای مناسب .NET را ساده‌تر کند. این مهارت‌ها برای توسعه قابلیت‌های جدید، مهاجرت تدریجی و بهبود observability سرویس‌ها مفید هستند.

چه چیزی می‌گیرید

  • ساخت و اصلاح endpointهای ASP.NET Core Web API با OpenAPI، خطاهای استاندارد و فایل‌های تست .http
  • راهنمای مهاجرت Blazor Server پیش از .NET 8 به مدل Blazor Web App
  • پیاده‌سازی endpointهای آپلود فایل با ASP.NET Minimal APIs در .NET 8+
  • تنظیم distributed tracing، metrics و logging با OpenTelemetry و OTLP exporter
  • تشخیص محدوده استفاده و محدودیت‌های هر مهارت برای جلوگیری از انتخاب مسیر اشتباه

برای چه کاری خوب است

  • تیم‌هایی که روی APIهای ASP.NET Core کار می‌کنند و به endpointهای استاندارد و مستندسازی OpenAPI نیاز دارند
  • پروژه‌هایی که باید از Blazor Server قدیمی به Blazor Web App در .NET 8+ مهاجرت کنند
  • سرویس‌هایی که به آپلود فایل، tracing توزیع‌شده یا metrics و logging قابل‌اعتماد نیاز دارند

برای چه کاری نیست

  • پروژه‌های Blazor WebAssembly یا hosted Blazor WebAssembly که مسیر مهاجرت متفاوتی دارند
  • توسعه gRPC، SignalR، کارهای frontend عمومی یا بهینه‌سازی queryهای EF Core
  • برنامه‌هایی که هنوز روی .NET Framework هستند یا قصد حفظ مدل فعلی Blazor Server را دارند

دربارهٔ این اسکیل

Install This Skill

/plugin marketplace add dotnet/skills
/plugin install dotnet-aspnetcore@dotnet-agent-skills

Get new skills in your inbox. What we added, what we rejected, and why. See a past issue.

Skill bundle — 4 sub-skills

upstream is a skill bundle

This catalog entry is a skill bundle that ships 4 individual SKILL.md files. Each one is listed below — click through to read the full markdown on GitHub.

[### configuring-opentelemetry-dotnet
Configure OpenTelemetry distributed tracing, metrics, and logging in ASP.NET Core using the .NET OpenTelemetry SDK. Use when adding observability, setting up OTLP exporters, creating custom metrics/spans, or troubleshooting distributed trace correlation.
plugins/dotnet-aspnet/skills/configuring-opentelemetry-dotnet](https://github.com/dotnet/skills/blob/main/plugins/dotnet-aspnet/skills/configuring-opentelemetry-dotnet/SKILL.md)[### convert-blazor-server-to-webapp

Guides conversion of a pre-.NET 8 Blazor Server app into a .NET 8+ Blazor Web App. USE FOR: migrating apps that use AddServerSideBlazor and MapBlazorHub to the AddRazorComponents/MapRazorComponents model, converting _Host.cshtml to an App.razor root component, replacing blazor.server.js with blazor.web.js, migrating CascadingAuthenticationState to a service, adopting new Blazor Web App features like enhanced navigation and streaming rendering. DO NOT USE FOR: apps that are already Blazor Web Apps (already use AddRazorComponents and MapRazorComponents), Blazor WebAssembly or hosted Blazor WebAssembly apps (different migration path), apps that should stay on the Blazor Server hosting model without converting, or apps still targeting .NET Framework.

plugins/dotnet-aspnet/skills/convert-blazor-server-to-webapp](https://github.com/dotnet/skills/blob/main/plugins/dotnet-aspnet/skills/convert-blazor-server-to-webapp/SKILL.md)[### dotnet-webapi

Guides creation and modification of ASP.NET Core Web API endpoints with correct HTTP semantics, OpenAPI metadata, and error handling. USE FOR: adding new API endpoints (controllers or minimal APIs), wiring up OpenAPI/Swagger, creating .http test files, setting up global error handling middleware. DO NOT USE FOR: general C# coding style, EF Core data access or query optimization (use optimizing-ef-core-queries), frontend/Blazor work, gRPC services, or SignalR hubs.

plugins/dotnet-aspnet/skills/dotnet-webapi](https://github.com/dotnet/skills/blob/main/plugins/dotnet-aspnet/skills/dotnet-webapi/SKILL.md)[### minimal-api-file-upload
File upload endpoints in ASP.NET minimal APIs (.NET 8+)
plugins/dotnet-aspnet/skills/minimal-api-file-upload](https://github.com/dotnet/skills/blob/main/plugins/dotnet-aspnet/skills/minimal-api-file-upload/SKILL.md)

دانلود ZIP