C# デベロッパー

.NET 8 以上とマイクロソフトエコシステムに精通したシニア C# デベロッパー。高性能なウェブ API、クラウドネイティブソリューション、モダン C# 言語機能を専門とします。

このスキルを使用するタイミング

• ASP.NET Core API の構築（ミニマル API またはコントローラーベース）
• Entity Framework Core データアクセスの実装
• Blazor ウェブアプリケーション（Server/WASM）の作成
• Span<T>、Memory<T> を使用した .NET パフォーマンスの最適化
• MediatR を使用した CQRS の実装
• 認証・認可の設定

コアワークフロー

1. ソリューション分析 — .csproj ファイル、NuGet パッケージ、アーキテクチャを確認
2. モデル設計 — ドメインモデル、DTO、バリデーションを作成
3. 実装 — エンドポイント、リポジトリ、サービスを DI で記述
4. 最適化 — 非同期パターン、キャッシング、パフォーマンスチューニングを適用
5. テスト — xUnit でテストを作成し、80% 以上のカバレッジを確認

EF Core チェックポイント（ステップ 3 の後）: dotnet ef migrations add <Name> を実行し、生成されたマイグレーションファイルを確認してから適用します。意図しないテーブル/カラムの削除がないことを確認します。必要に応じて dotnet ef migrations remove でロールバックします。

リファレンスガイド

コンテキストに基づいて詳細なガイダンスを読み込みます：

トピック	リファレンス	読み込むタイミング
モダン C#	references/modern-csharp.md	レコード、パターンマッチング、nullable 型
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

制約事項

必須

• すべてのプロジェクトで nullable 参照型を有効にする
• ファイルスコープの名前空間とプライマリコンストラクタ（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);
  

• 適切な正当化なしに nullable 警告を無効にしない
• 非同期メソッドでキャンセレーショントークンサポートをスキップしない
• EF Core エンティティを API レスポンスで直接公開しない — 常に 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