mcpField
D
dotnet-core-expert

dotnet-core-expert

github.com/jeffallan开发12.1k4.8k 次安装今天更新
代码仓库

关于 dotnet-core-expert

专注于现代 .NET 8 和 C# 12 实践的 .NET Core 开发技能，指导整洁架构、安全 API 实现、EF Core 使用，并通过构建和测试进行验证。

主要功能

  1. 01整洁架构指导
  2. 02现代 .NET 8 与 C# 12 模式
  3. 03Minimal API 与 OpenAPI 指导
  4. 04EF Core 与身份验证参考
  5. 05构建与集成测试工作流

适用场景

  1. 01设计分层 .NET 解决方案
  2. 02实现安全 API
  3. 03使用 EF Core 构建数据访问
  4. 04通过构建和测试验证应用

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/jeffallan/claude-skills --skill dotnet-core-expert

安装后在 Claude Code 中输入/dotnet-core-expert确认已加载。

包含的文件

除 SKILL.md 外，安装时一起下载的参考资料和脚本。

references/
authentication.md
clean-architecture.md
cloud-native.md
entity-framework.md
minimal-apis.md

详细介绍

.NET Core 专家

核心工作流

  1. 分析需求 — 确定架构模式、数据模型和 API 设计
  2. 设计解决方案 — 创建职责分离清晰的分层架构
  3. 实现 — 使用现代 C# 特性编写高性能代码；运行 dotnet build 验证编译结果 — 如果构建失败，检查错误、修复问题，并重新构建后再继续
  4. 保障安全 — 添加身份验证、授权并遵循安全最佳实践
  5. 测试 — 使用 xUnit 编写全面的测试并进行集成测试；运行 dotnet test 确认所有测试通过 — 如果测试失败，诊断失败原因、修复实现，并在继续前重新运行；使用 curl 或 REST 客户端验证端点

参考指南

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

主题参考资料加载时机
Minimal APIsreferences/minimal-apis.md创建端点、路由、中间件时
Clean Architecturereferences/clean-architecture.md使用 CQRS、MediatR、分层和 DI 模式时
Entity Frameworkreferences/entity-framework.md使用 DbContext、迁移和关系时
Authenticationreferences/authentication.md使用 JWT、Identity 和授权策略时
Cloud-Nativereferences/cloud-native.md使用 Docker、运行状况检查和配置时

约束

必须执行
  • 使用 .NET 8 和 C# 12 特性
  • 启用可空引用类型：在 .csproj 中设置 <Nullable>enable</Nullable>
  • 所有 I/O 操作都使用 async/await — 例如，await dbContext.Users.ToListAsync()
  • 正确实现依赖注入
  • DTO 使用 record 类型 — 例如，public record UserDto(int Id, string Name);
  • 遵循整洁架构原则
  • 使用 WebApplicationFactory<Program> 编写集成测试
  • 配置 OpenAPI/Swagger 文档
禁止执行
  • 使用同步 I/O 操作
  • 在 API 响应中直接暴露实体
  • 跳过输入验证
  • 使用旧版 .NET Framework 模式
  • 混淆各架构层的职责
  • 使用已弃用的 EF Core 模式

代码示例

Minimal API 端点
// Program.cs
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddEndpointsApiExplorer();
builder.Services.AddSwaggerGen();
builder.Services.AddMediatR(cfg => cfg.RegisterServicesFromAssembly(typeof(Program).Assembly));

var app = builder.Build();
app.UseSwagger();
app.UseSwaggerUI();

app.MapGet("/users/{id}", async (int id, ISender sender, CancellationToken ct) =>
{
    var result = await sender.Send(new GetUserQuery(id), ct);
    return result is null ? Results.NotFound() : Results.Ok(result);
})
.WithName("GetUser")
.Produces<UserDto>()
.ProducesProblem(404);

app.Run();
MediatR 查询处理程序
// Application/Users/GetUserQuery.cs
public record GetUserQuery(int Id) : IRequest<UserDto?>;

public sealed class GetUserQueryHandler : IRequestHandler<GetUserQuery, UserDto?>
{
    private readonly AppDbContext _db;

    public GetUserQueryHandler(AppDbContext db) => _db = db;

    public async Task<UserDto?> Handle(GetUserQuery request, CancellationToken ct) =>
        await _db.Users
            .AsNoTracking()
            .Where(u => u.Id == request.Id)
            .Select(u => new UserDto(u.Id, u.Name))
            .FirstOrDefaultAsync(ct);
}
使用异步查询的 EF Core DbContext
// Infrastructure/AppDbContext.cs
public sealed class AppDbContext(DbContextOptions<AppDbContext> options) : DbContext(options)
{
    public DbSet<User> Users => Set<User>();

    protected override void OnModelCreating(ModelBuilder modelBuilder)
    {
        modelBuilder.ApplyConfigurationsFromAssembly(typeof(AppDbContext).Assembly);
    }
}

// Usage in a service
public async Task<IReadOnlyList<UserDto>> GetAllAsync(CancellationToken ct) =>
    await _db.Users
        .AsNoTracking()
        .Select(u => new UserDto(u.Id, u.Name))
        .ToListAsync(ct);
使用 Record 类型的 DTO
public record UserDto(int Id, string Name);
public record CreateUserRequest(string Name, string Email);

输出模板

实现 .NET 功能时，请提供：

  1. 项目结构（解决方案/项目文件）
  2. 领域模型和 DTO
  3. API 端点或服务实现
  4. 数据库上下文和迁移（如适用）
  5. 对架构决策的简要说明

由 @jeffallan（Synergetic Solutions 首席顾问）维护

文档

评论

支持 Markdown