dotnet-csharp

dotnet-csharp

概要

慣用的で高パフォーマンスなコードを書くための、C# 言語のパターン、コーディング標準、.NET ランタイムの機能を扱います。この統合スキルは、25 のトピック領域をカバーしています。以下のルーティング表に基づいて、references/ から適切な補助ファイルを読み込んでください。

常に読み込む基本リファレンス

以下のリファレンスでは、すべての C# コードに適用される正確性と品質の基準を定めています。ユーザーの依頼内容にかかわらず、コードを作成またはレビューするときは、既定で読み込んでください。

• references/coding-standards.md — 命名規則、ファイル構成、スタイル規則
• references/async-patterns.md — async/await の正確な使用、ConfigureAwait、キャンセルの伝播（ほぼすべての .NET コードで非同期処理を使用します）
• references/solid-principles.md — SOLID、DRY、単一責任、依存性逆転、アンチパターンの検出
• references/code-smells.md — 指示されなくてもエージェントが避けるべき一般的なミス（async void、DI のライフタイムの誤用、例外の握りつぶし）
• references/dotnet-releases.md — .NET 10/11 と C# 14/15 の機能、バージョンマトリックス、TFM 固有のコード生成ルール（トレーニングデータのカットオフを補います）

必要に応じて読み込むリファレンス

トピックが該当する場合は読み込んでください（キーワードはルーティング表を参照）。

ルーティング表

トピック	キーワード	説明	関連ファイル
コーディング規約	命名、ファイル構成、スタイルルール	C# の基本的な規約（命名、構成、スタイルルール）	references/coding-standards.md
Async/await	async、Task、ConfigureAwait、キャンセル	async/await、Task のパターン、ConfigureAwait、キャンセル	references/async-patterns.md
依存性注入	DI、サービス、スコープ、キー付き、ライフタイム	MS DI、キー付きサービス、スコープ、デコレーション、ライフタイム	references/dependency-injection.md
構成	Options パターン、ユーザーシークレット、機能フラグ	Options パターン、ユーザーシークレット、機能フラグ、IOptions<T>	references/configuration.md
ソースジェネレーター	IIncrementalGenerator、GeneratedRegex、LoggerMessage	IIncrementalGenerator、GeneratedRegex、LoggerMessage、STJ	references/source-generators.md
Nullable 参照型	注釈、移行、エージェントのミス	注釈の戦略、移行、エージェントのミス	references/nullable-reference-types.md
シリアル化	System.Text.Json、Protobuf、MessagePack、AOT	System.Text.Json のソースジェネレーター、Protobuf、MessagePack	references/serialization.md
チャネル	Channel<T>、有界／無界、バックプレッシャー	Channel<T>、有界／無界、バックプレッシャー、ドレイン	references/channels.md
LINQ の最適化	IQueryable と IEnumerable、コンパイル済みクエリ	IQueryable と IEnumerable、コンパイル済みクエリ、割り当て	references/linq-optimization.md
ドメインモデリング	集約、値オブジェクト、ドメインイベント	集約、値オブジェクト、ドメインイベント、リポジトリ	references/domain-modeling.md
SOLID 原則	SRP、DRY、アンチパターン、準拠チェック	SOLID と DRY の原則、C# のアンチパターン、修正	references/solid-principles.md
並行処理	lock、SemaphoreSlim、Interlocked、並行コレクション	lock、SemaphoreSlim、Interlocked、並行コレクション	references/concurrency-patterns.md
Roslyn アナライザー	DiagnosticAnalyzer、CodeFixProvider、複数バージョン	DiagnosticAnalyzer、CodeFixProvider、CodeRefactoring	references/roslyn-analyzers.md
Editorconfig	IDE/CA の重大度、AnalysisLevel、globalconfig	IDE/CA の重大度、AnalysisLevel、globalconfig、適用	references/editorconfig.md
ファイル I/O	FileStream、RandomAccess、FileSystemWatcher、パス	FileStream、RandomAccess、FileSystemWatcher、MemoryMappedFile	references/file-io.md
ネイティブ相互運用	P/Invoke、LibraryImport、ComWrappers、マーシャリング	P/Invoke、LibraryImport、ComWrappers、マーシャリング、クロスプラットフォーム	references/native-interop.md
入力検証	.NET 10 AddValidation、FluentValidation	.NET 10 AddValidation、FluentValidation、ProblemDetails	references/input-validation.md
検証パターン	DataAnnotations、IValidatableObject、IValidateOptions	DataAnnotations、IValidatableObject、IValidateOptions<T>	references/validation-patterns.md
モダンなパターン	レコード、パターンマッチング、プライマリコンストラクター	レコード、パターンマッチング、プライマリコンストラクター、C# 12-15	references/modern-patterns.md
API 設計	命名、パラメーターの順序、戻り値の型、拡張	命名、パラメーターの順序、戻り値の型、エラーパターン	references/api-design.md
型設計／パフォーマンス	struct と class、sealed、Span/Memory、コレクション	struct と class、sealed、Span/Memory、コレクション	references/type-design-performance.md
コードの臭い	アンチパターン、async の誤用、DI の誤り、修正	アンチパターン、async の誤用、DI の誤り、修正	references/code-smells.md
.NET リリース	.NET 10、.NET 11、C# 14、C# 15、TFM、バージョン、共用体、拡張ブロック、field キーワード	バージョンマトリックス、新機能、TFM 固有のコード生成	references/dotnet-releases.md
グローバリゼーション	CultureInfo、StringComparison、TimeZoneInfo、Rune、エンコーディング	カルチャーを考慮したコーディング、文字列比較、タイムゾーン、文字処理	references/globalization.md
WASM 相互運用	JSImport、JSExport、スタンドアロン WASM、wasm-experimental、ブラウザー	JSImport/JSExport、スタンドアロン .NET WASM、ブラウザー API、WASM AOT	references/wasm-interop.md

対象範囲

• C# 言語機能（C# 8-15）
• .NET ランタイムのパターン（async、DI、構成、シリアル化、チャネル、LINQ）
• コード品質（アナライザー、editorconfig、コードスメル、SOLID）
• 型設計とドメインモデリング
• ファイル I/O とネイティブ相互運用
• グローバリゼーション（文字列比較、CultureInfo、タイムゾーン、文字処理、エンコーディング）
• モデルレベルでの入力検証（DataAnnotations、IValidatableObject、FluentValidation、Options の検証）

対象外

• ASP.NET Core／Web API のパターン（リクエストレベルの検証、エンドポイントフィルター）→ dotnet-api
• UI フレームワークのパターン → dotnet-ui
• テストのパターン → dotnet-testing
• ビルド／MSBuild／プロジェクトのセットアップ → dotnet-tooling
• パフォーマンスプロファイリングツール → dotnet-tooling