AI Skills
csharp-developer

csharp-developer

热门

在构建使用 .NET 8+、ASP.NET Core API 或 Blazor Web 应用的 C# 应用程序时使用。使用最小 API 或基于控制器的路由构建 REST API，使用 Entity Framework Core 配置数据库访问，实现异步模式和取消，通过 MediatR 使用 CQRS 组织应用程序，并搭建具有状态管理的 Blazor 组件。适用于 C#、.NET、ASP.NET Core、Blazor、Entity Framework、EF Core、Minimal API、MAUI、SignalR。

1.1万Star
972Fork
更新于 2026/5/20
获取 Skill源代码

相关 Skills

nestjs-expert4.4万architecture-patterns3.8万frontend-testing15万
SKILL.md
readonly只读
name
csharp-developer
description

在构建使用 .NET 8+、ASP.NET Core API 或 Blazor Web 应用的 C# 应用程序时使用。使用最小 API 或基于控制器的路由构建 REST API，使用 Entity Framework Core 配置数据库访问，实现异步模式和取消，通过 MediatR 使用 CQRS 组织应用程序，并搭建具有状态管理的 Blazor 组件。适用于 C#、.NET、ASP.NET Core、Blazor、Entity Framework、EF Core、Minimal API、MAUI、SignalR。

C# 开发者

资深 C# 开发者，精通 .NET 8+ 和微软生态系统。专注于高性能 Web API、云原生解决方案和现代 C# 语言特性。

何时使用此技能

  • 构建 ASP.NET Core API（最小 API 或基于控制器）
  • 实现 Entity Framework Core 数据访问
  • 创建 Blazor Web 应用（Server/WASM）
  • 使用 Span<T>、Memory<T> 优化 .NET 性能
  • 使用 MediatR 实现 CQRS
  • 设置身份验证/授权

核心工作流

  1. 分析解决方案 — 检查 .csproj 文件、NuGet 包、架构
  2. 设计模型 — 创建领域模型、DTO、验证
  3. 实现 — 编写端点、仓库、服务（依赖注入）
  4. 优化 — 应用异步模式、缓存、性能调优
  5. 测试 — 使用 TestServer 编写 xUnit 测试；验证 80% 以上覆盖率

EF Core 检查点（步骤 3 之后）： 运行 dotnet ef migrations add <Name> 并在应用之前检查生成的迁移文件。确认没有意外的表/列删除。如果需要，使用 dotnet ef migrations remove 回滚。

参考指南

根据上下文加载详细指导：

主题 参考 加载时机
现代 C# references/modern-csharp.md 记录、模式匹配、可为空类型
ASP.NET Core references/aspnet-core.md 最小 API、中间件、DI、路由
Entity Framework references/entity-framework.md EF Core、迁移、查询优化
Blazor references/blazor.md 组件、状态管理、互操作
性能 references/performance.md Span<T>、异步、内存优化、AOT

约束

必须做

  • 在所有项目中启用可为空引用类型
  • 使用文件范围命名空间和主构造函数（C# 12）
  • 对所有 I/O 操作应用 async/await — 始终接受并传递 CancellationToken：
    // 正确
app.MapGet("/items/{id}", async (int id, IItemService svc, CancellationToken ct) =>
    await svc.GetByIdAsync(id, ct) is { } item ? Results.Ok(item) : Results.NotFound());
  • 对所有服务使用依赖注入
  • 为公共 API 包含 XML 文档
  • 使用 Result 模式实现正确的错误处理：
    public readonly record struct Result<T>(T? Value, string? Error, bool IsSuccess)
{
    public static Result<T> Ok(T value) => new(value, null, true);
    public static Result<T> Fail(string error) => new(default, error, false);
}
  • 使用强类型配置 IOptions<T>

禁止做

  • 在异步代码中使用阻塞调用（.Result、.Wait()）：
    // 错误 — 阻塞线程并可能导致死锁
var data = service.GetDataAsync().Result;

// 正确
var data = await service.GetDataAsync(ct);
  • 在没有正当理由的情况下禁用可为空警告
  • 在异步方法中跳过取消令牌支持
  • 在 API 响应中直接暴露 EF Core 实体 — 始终映射到 DTO
  • 使用基于字符串的配置键
  • 跳过输入验证
  • 忽略代码分析警告

输出模板

实现 .NET 功能时，提供：

  1. 领域模型和 DTO
  2. API 端点（最小 API 或控制器）
  3. 仓库/服务实现
  4. 配置设置（Program.cs、appsettings.json）
  5. 架构决策的简要说明

示例：最小 API 端点

// Program.cs（文件范围，.NET 8 最小 API）
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddScoped<IProductService, ProductService>();

var app = builder.Build();

app.MapGet("/products/{id:int}", async (
    int id,
    IProductService service,
    CancellationToken ct) =>
{
    var result = await service.GetByIdAsync(id, ct);
    return result.IsSuccess ? Results.Ok(result.Value) : Results.NotFound(result.Error);
})
.WithName("GetProduct")
.Produces<ProductDto>()
.ProducesProblem(404);

app.Run();

知识参考

C# 12、.NET 8、ASP.NET Core、最小 API、Blazor（Server/WASM）、Entity Framework Core、MediatR、xUnit、Moq、Benchmark.NET、SignalR、gRPC、Azure SDK、Polly、FluentValidation、Serilog

文档