菜单
Creates a CQRS command + handler + in-memory test in a NestJS hexagonal module. Use when adding a write operation (state change) to a module. Command and handler live in the same file. Requires /api-setup-shared.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Adds a new domain error to an existing module — extends the module base error, sets error code and monitoring flag, and updates the exception filter mapping. Use when a command or query needs to throw a new business error. Requires /api-add-module.
Adds a new HTTP endpoint to an existing controller — request/response DTOs, Swagger decorators, and command/query wiring. Use after the module, entity, and command/query already exist. Requires /api-setup-shared and /api-add-module.
Creates a complete domain entity in a NestJS hexagonal module — entity, repository interface, test builder, unit tests, SQL repository, in-memory repository, mapper, and optionally domain events. Supports both standalone entities and AggregateRoot entities with domain event publishing. Use when adding a new aggregate to a module's domain layer.
Creates a domain event handler that reacts to events from another module (or the same module). Includes handler class and unit test. Use after domain events have been created with /api-add-domain-entity.
Creates a CQRS query + handler + integration test in a NestJS hexagonal module. Use when adding a read operation (data retrieval) to a module. Query and handler live in the same file. Handlers bypass the domain and repository layers entirely — direct PrismaService only. Requires /api-setup-shared.
Creates all shared infrastructure required for hexagonal NestJS modules — TypedCommand, TypedQuery, TypedCommandBus, TypedQueryBus, CorrelationId decorator, PaginatedQueryBase, BaseDomainError, BaseFeatureExceptionFilter, the BaseLogger pattern (wrapping nestjs-pino), ZodValidationPipe with @ZodSchema decorator, PrismaService + PrismaModule (global), validateEnv helper, CqrsInterceptor (bus observer), LoggingInterceptor (HTTP request logger), DomainEvent base class, SqlRepositoryBase (generic Prisma CRUD + auto event publishing), and IDateProvider + DateProvider + FakeDateProvider (date abstraction for deterministic testing). Run once per project before using other api-* skills.
| name | api-add-command |
| description | Creates a CQRS command + handler + in-memory test in a NestJS hexagonal module. Use when adding a write operation (state change) to a module. Command and handler live in the same file. Requires /api-setup-shared. |
Creates {command-name}.command.ts (command + handler) and {command-name}.command.spec.ts (in-memory test), then registers the handler.
Read the ## Configuration section in .claude/CLAUDE.md for {SHARED_ROOT} and {MODULE_ROOT}.
Run these skills first (in order):
/api-init-project — project scaffold/api-setup-shared — shared base classes (TypedCommand, BaseDomainError, etc.)/api-add-module — module scaffold (tokens, errors, controller)/api-add-domain-entity — entity, repository, builder, in-memory repoCreate folder — application/commands/{command-name}/
Name in kebab-case, imperative verb: join-campaign, create-order, cancel-subscription.
Create command file — {command-name}.command.ts
Load references/command-template.md for the exact structure.
Create test file — {command-name}.command.spec.ts
Load references/test-template.md for the exact structure.
If using BaseLogger, pass new InMemoryLogger() as the second constructor argument.
Register handler — add XxxCommandHandler to the providers array in
application/{module-name}.module.ts and add the corresponding import at the top of that file.
InMemorySomeRepository or SomeBuilder — run /api-add-domain-entity first.BaseLogger, use NestJS native Logger or omit.