add-feature
/add-feature
Dodaje funkcję w układzie vertical slice (komenda lub zapytanie, handler, walidator, endpoint) do istniejącego modułu FSH.
- Autor
- fullstackhero ↗
- Repozytorium
- dotnet-starter-kit ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 09.10.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 09.10.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
Co robi i kiedy
Dodaje funkcję w układzie vertical slice (komenda lub zapytanie, handler, walidator, endpoint) do istniejącego modułu FSH.
Argumenty
/add-feature [ModuleName] [Area] [FeatureName]
Oryginalny opis (EN)
Add a vertical-slice feature (command/query + handler + validator + endpoint) to an existing FSH module. Use when adding an API endpoint or business operation to a module that already exists.
Jak działa
- Layout (real)
- Step 1 — Command/Query (Contracts project)
- Step 2 — Handler (runtime Features/) — inject the DbContext, NOT a repository
- Step 3 — Validator (required; same folder)
- Step 4 — Endpoint (same folder)
- Step 5 — Wire it in {X}Module.MapEndpoints
- Step 6 — Verify
- Checklist
Podgląd SKILL.md
---
name: add-feature
description: Add a vertical-slice feature (command/query + handler + validator + endpoint) to an existing FSH module. Use when adding an API endpoint or business operation to a module that already exists.
argument-hint: "[ModuleName] [Area] [FeatureName]"
---
# Add Feature
A feature is a vertical slice **split across two projects**: the request/response types live in the
module's `.Contracts` project (public API); the handler, validator, and endpoint live in the runtime
project. Full conventions: `.agents/rules/api-conventions.md`.
## Layout (real)
```
src/Modules/{X}/Modules.{X}.Contracts/v1/{Area}/{Feature}Command.cs # ICommand<T>/IQuery<T>
src/Modules/{X}/Modules.{X}.Contracts/Dtos/{Entity}Dto.cs # response DTOs (if any)
src/Modules/{X}/Modules.{X}/Features/v1/{Area}/{Feature}/
├── {Feature}CommandHandler.cs # public sealed, injects the DbContext directly
├── {Feature}CommandValidator.cs # required for commands + paginated queries
└── {Feature}Endpoint.cs # internal static extension
```
## Step 1 — Command/Query (Contracts project)
`Mediator` interfaces (`using Mediator;`). Records. A create command can return the raw `Guid`.
```csharp
namespace FSH.Modules.{X}.Contracts.v1.{Area};
public sealed record Create{Entity}Command(string Name, decimal PriceAmount, string PriceCurrency)
: ICommand<Guid>;
```
Read/list DTOs go in `Modules.{X}.Contracts/Dtos/`. Paginated queries return `PagedResponse<T>`
(`FSH.Framework.Shared.Persistence`) — see `query-patterns`.
## Step 2 — Handler (runtime `Features/`) — inject the DbContext, NOT a repository
There is **no generic `IRepository<T>`**. Inject the module's `{X}DbContext`. `public sealed`, primary
ctor, `ValueTask<T>`, `.ConfigureAwait(false)`, guard first. Tenant/audit fields are auto-stamped — only
inject `ICurrentUser` if you need the acting user (`GetUserId()` / `GetTenant()`).
```csharp
public sealed class Create{Entity}CommandHandler(CatalogDbContext dbContext)
: ICommandHandler<Create{Entity}Command, Guid>
{
public async ValueTask<Guid> Handle(Create{Entity}Command command, CancellationToken cancellationToken)
{
ArgumentNullException.ThrowIfNull(command);
var entity = {Entity}.Create(command.Name, new Money(command.PriceAmount, command.PriceCurrency));
dbContext.{Entities}.Add(entity);
await dbContext.SaveChangesAsync(cancellationToken).ConfigureAwait(false);
return entity.Id;
}
}
```
Throw `NotFoundException` / `CustomException(msg, errors, HttpStatusCode)` (`FSH.Framework.Core.Exceptions`) — the global handler maps them to ProblemDetails.
## Step 3 — Validator (required; same folder)
```csharp
public sealed class Create{Entity}CommandValidator : AbstractValidator<Create{Entity}Command>
{
public Create{Entity}CommandValidator()
{
RuleFor(x => x.Name).NotEmpty().MaximumLength(200);
RuleFor(x => x.PriceCurrency).NotEmpty().Length(3);
}
}
```
`Architecture.Tests` fails the build if a command/paginated-query handler has no `{Name}Validator`.
## Step 4 — Endpoint (same folder)
```csharp
public static class Create{Entity}Endpoint
{
internal static RouteHandlerBuilder MapCreate{Entity}Endpoint(this IEndpointRouteBuilder endpoints) =>
endpoints.MapPost("/{entities}",
async (Create{Entity}Command command, IMediator mediator, CancellationToken ct) =>
Results.Ok(await mediator.Send(command, ct)))
.WithName("Create{Entity}")
.WithSummary("Create a {entity}")
.RequirePermission({X}Permissions.{Entities}.Create)
.WithIdempotency(); // on replay-safe POSTs
}
```
## Step 5 — Wire it in `{X}Module.MapEndpoints`
```csharp
group.MapCreate{Entity}Endpoint(); // group = endpoints.MapGroup("api/v{version:apiVersion}/{x}") …
```
## Step 6 — Verify
```bash
dotnet build src/FSH.Starter.slnx # 0 warnings (TreatWarningsAsErrors)
dotnet test src/Tests/{X}.Tests # + add a handler/validator test (see testing-guide)
```
## Checklist
- [ ] Command/Query in the **Contracts** project (`using Mediator;`), DTOs in `Contracts/Dtos/`
- [ ] Handler `public sealed`, injects `{X}DbContext` (no repository), `ValueTask<T>` + `.ConfigureAwait(false)`
- [ ] `{Name}Validator` exists
- [ ] Endpoint `internal static …Map{Feature}Endpoint`, `.RequirePermission(...)`, `.WithName/.WithSummary`
- [ ] Wired in `{X}Module.MapEndpoints`
- [ ] Build 0 warnings; test added
Wersje
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · fullstackhero/dotnet-starter-kit | 100 | MIT |
| nvidia/nvcf | 100 | Apache-2.0 |
| gosodax/sodax-sdks | 100 | MIT |
| opusgamelabs/game-creator | 100 | MIT |
| Q-Sharp/CloudGround | 100 | MIT |
| ialameh/sift-coder | 100 | MIT |
| onewave-ai/open-agent-stack | 90 | MIT |
| JamieMason/syncpack | 90 | MIT |
| gazi-faysal-jubayer/shapebridge | 86 | Apache-2.0 |
Migawka bazy z 13.11.2026 · wersja paczki 37186254ae0e (skrót SHA-256 całej paczki)
Pobrania w ostatnich 30 dniach: 0 · ranking
Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.
Podobne skille
- 100add-full-slice
Buduje funkcję od początku do końca: pionowy wycinek backendu (kontrakty, handler, walidator, endpoint) oraz podpiętą do niego stronę React, łącząc add-feature i add-react-page. - 100add-entity
Dodaje encję lub agregat domenowy z konfiguracją EF i migracją do istniejącego modułu FSH, gdy potrzebny jest nowy byt w bazie danych. - 100scaffold
Generuje w .NET 10 kompletne przekroje funkcji zgodne z wykrytą architekturą: endpoint, handler, walidator, DTO, konfigurację EF i testy integracyjne. - 100add-command
Dodaje kompletny przepływ komendy do istniejącego agregatu Protean: klasę komendy, endpoint FastAPI i handler z logiką repozytorium, czyli operację zapisu. - 95add-command
Dodaje obsługę nowego polecenia CLI, pisze jego handler i wpisuje je na listę SIMPLE_SAFE. - 100add-use-case
Buduje w Protean kompletny pionowy wycinek: definicja komendy, handler, zmiana agregatu, zgłoszenie zdarzenia i reakcja handlera zdarzenia, czyli najczęstszy przepływ dodawania nowej funkcji.