菜单
Scaffold a feature module under src/modules/<plural>/ — entity, repository, service, audience-scoped controllers, DTOs, i18n stub, AppModule wiring. Triggers: "create a new module", "scaffold feature X", "/init-feature-module", new domain entity with API surface.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
Add an HTTP endpoint to an existing module — updates the audience-scoped controller (creates one if needed), DTO, service method, and i18n keys for any new error messages. Triggers: "add an endpoint", "expose endpoint X on module Y", "add a route to <module>", "/add-endpoint".
Add a TypeORM entity to an existing module — entity file, repository, TypeOrmModule.forFeature registration, generated migration. Triggers: "add an entity", "add a table", "add <Entity> to module X", "/add-entity".
Add mirrored Arabic + English translation keys to src/infrastructure/i18n/translations/{ar,en}/<feature>.json, then regenerate translation-keys.ts via npm run i18n:sync. Triggers: "add a translation", a Translator.tr('<key>') call without a matching JSON key, "/add-i18n-keys".
Generate a new role-scoped controller for an existing module (e.g. admin-foo.controller.ts next to user-foo.controller.ts). Wires @Protected(Role.X), the path/version, and registers in the module. Triggers: "expose this module to admins/users", "add an admin controller for <module>", "/add-protected-controller".
Diagnose and break a circular dependency between NestJS modules or providers — without reaching for forwardRef. Triggers: Nest "circular dependency" / "can't resolve dependencies" startup error, "ModuleA imports ModuleB and back", a new cross-module service injection, "how do I avoid a cycle", "/circular-deps".
Apply when writing, reviewing, or removing comments. Triggers: /comments, "should I comment this", "is this comment good", "explain why this code does X".
| name | init-feature-module |
| description | Scaffold a feature module under src/modules/<plural>/ — entity, repository, service, audience-scoped controllers, DTOs, i18n stub, AppModule wiring. Triggers: "create a new module", "scaffold feature X", "/init-feature-module", new domain entity with API surface. |
Output must match existing modules (cities, areas, users) in shape and naming. Naming details: @../naming-conventions/SKILL.md.
<FeatureName> — kebab-case singular (refresh-token). Pluralised for folder/module class (refresh-tokens/, RefreshTokensModule); singular for entity/service/controller files.--entity <EntityName> — primary entity class. Default: <Feature>Entity.--audiences <list> — comma-separated subset of admin,user,public. Default: admin; ask once if ambiguous.--no-controller — skip controller generation (internal-only module).Glob src/modules/<plural>/ — if exists, stop and tell the user.cities, areas): their *.module.ts, an entity, a repository, one controller — to mirror current style (decorator order, version: '1', @HttpCode, response DTO mapping).src/modules/<plural>/
├── <plural>.module.ts # class: <Plural>Module
├── controllers/ # one per audience
│ ├── admin-<feature>.controller.ts
│ ├── user-<feature>.controller.ts
│ └── <feature>.controller.ts # public, audience-agnostic
├── dto/
│ ├── create-<feature>.dto.ts
│ ├── update-<feature>.dto.ts
│ ├── list-<plural>-query.dto.ts
│ └── <feature>-response.dto.ts
├── entities/<feature>.entity.ts # class: <Feature>Entity
├── enums/<feature>-status.enum.ts (only if needed)
├── repositories/<feature>.repository.ts
└── services/<feature>.service.ts
File-shape rules per file kind: @file-shapes.md.
Create src/infrastructure/i18n/translations/{ar,en}/<feature>.json (use city.json as reference):
{ "errors": { "not_found": "{Feature} not found." } }
Edit src/app.module.ts:
import { <Plural>Module } from 'modules/<plural>/<plural>.module'; (alphabetical).<Plural>Module to imports: under "Feature modules" (alphabetical).npm run i18n:syncnpm run lintnpm run buildFix root causes — never skip hooks or weaken types.
✓ Module created: src/modules/<plural>/ (entity, repository, service, <N> controllers, <M> DTOs, i18n stub)
✓ Wired into AppModule
✓ i18n / lint / build green
Next:
- Add columns to <Feature>Entity, then `npm run migration:generate -- src/database/migrations/Create<Feature>`
- Add endpoints via /add-endpoint
- Add real i18n keys via /add-i18n-keys
api/application/domain/infrastructure inside the module.modules/admin/ — they belong here.Logger field, console.log, fire-and-forget try/catch.translation-keys.ts.synchronize: true or skipping migrations.