haxen/skills-test

keyed-service

Enforces C keyed-service constructor parameter naming based on the keyed service name, not the interface type, using the key's final segment and appropriate Query/Command suffixes in camelCase.

Ver código fuente

Cómo usar

  1. Copia el comando y revisa el paquete antes de instalarlo en tu entorno de agente.
  2. Consulta las herramientas, credenciales y entornos necesarios en el documento original.
  3. Describe las entradas y el resultado deseado; contrasta la salida con las fuentes.
npx skills add https://github.com/haxen/skills-test --skill keyed-service

Antes de empezar

  • La instalación no incluye suscripción al modelo, cuota API ni permisos sobre tus archivos.
  • Las estrellas e instalaciones reflejan actividad, no una prueba independiente de calidad o seguridad.
Documento original del Skill

Contenido del repositorio de origen con títulos, ejemplos, código, tablas, enlaces e imágenes preservados.

modul-connect/naming-conventions/keyed-service

C# Keyed Service Naming Convention

Rule Definition

When generating or refactoring C# constructors using the [FromKeyedServices] attribute, the parameter name must be derived from the Key Argument rather than the Interface Type.

Logic & Transformation

  1. Source of Truth: Use the value inside [FromKeyedServices(...)] (e.g., ModulConnect.Queries.Postgres.Backoffice).
  2. Identifier Extraction: Take the last segment of the Key (e.g., Backoffice).
  3. Contextual Suffixing: - If the namespace contains .Queries., append Query.
  • If the namespace contains .Commands., append Command.
  1. Casing: Convert the result to camelCase for the parameter and _camelCase for the private field.

Examples

✅ Correct (Key-Derived)

csharp
public class OrderProcessor(
    [FromKeyedServices(ModulConnect.Queries.Postgres.Backoffice)] 
    IDataAccess backofficeQuery) 
{
    private readonly IDataAccess _backofficeQuery = backofficeQuery;
}

❌ Incorrect (Type-Derived)

csharp
// DO NOT use the interface name "dataAccess"
public class OrderProcessor(
    [FromKeyedServices(ModulConnect.Queries.Postgres.Backoffice)] 
    IDataAccess dataAccess) 
{ 
    /* ... */ 
}

Rationale

In a modular architecture, the interface (e.g., IDataAccess) defines the contract, but the Key defines the instance's specific responsibility. Naming the parameter after the Key prevents naming collisions when multiple implementations of the same interface are injected and provides immediate semantic clarity.

Relacionados por tarea