C# Conventions

Reglas internas de C# 12 / .NET 8: patrón Result, higiene de consultas EF, disciplina asíncrona

Por alexander-danilenko · alexander-danilenko/cortex-ai-skills

Probado · Funciona ★ 8.0/10

C# Conventions — Reglas internas de C# 12 / .NET 8: patrón Result, higiene de consultas EF, disciplina asíncrona

Qué hace

Un conjunto compacto de convenciones opinadas de C# 12 / .NET 8+ que cubren nullable-as-errors, records y constructores primarios, el patrón Result para fallas esperadas, CancellationToken en cada método async, IOptions y IHttpClientFactory, y reglas de EF Core como AsNoTracking, AsSplitQuery, ExecuteUpdateAsync y filtros de consulta globales de soft-delete. Se carga cada vez que escribes o revisas C# en una base de código ASP.NET Core, EF Core o Blazor. Ten en cuenta que, a pesar del README del repositorio, la guía de CQRS/MediatR reside en la skill hermana dotnet-core, no aquí.

Informe de la prueba

Lo ejecuté contra un controlador ASP.NET Core deliberadamente roto y lo comparé con una revisión sin skill del mismo archivo. La skill produjo siete correcciones concretas que la revisión simple no hizo, incluyendo el único error latente genuino: PurgeInactive establece IsDeleted pero no tiene filtros de consulta, y la convención global HasQueryFilter de la skill detecta que los usuarios con soft-delete siguen apareciendo en GET /users/{id}. También nombró APIs exactas que la revisión genérica solo insinuó — AsSplitQuery para los dos Includes de colección, ExecuteUpdateAsync para el cambio masivo de flags, IOptions con ValidateOnStart para la clave API tipada como cadena. Su punto ciego es la seguridad: el cuerpo no dice nada sobre la SQL injection interpolada FromSqlRaw o la contraseña sa codificada, ambas detectadas por la revisión sin skill. 573 palabras, sin scripts y sin archivos empaquetados que se deterioren, y la afirmación 'CQRS with MediatR' del README del repositorio para esta skill es en realidad contenido de la skill hermana dotnet-core.

Probado el: 2026-08-07 · Claude Code 2.x (agent harness)

Instalación

git clone https://github.com/alexander-danilenko/cortex-ai-skills.git
mkdir -p ~/.claude/skills
cd cortex-ai-skills && cp -r skills/csharp ~/.claude/skills/csharp

Comandos y prompts de ejemplo

  • /csharpReglas internas de C# 12 / .NET 8: patrón Result, higiene de consultas EF, disciplina asíncrona

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

  • Review this ASP.NET Core controller for our C# 12 conventions
  • Rewrite this EF Core query to use AsNoTracking and AsSplitQuery
  • Add CancellationToken and the Result pattern to this async method