菜单
Scaffold a new NestJS endpoint/module/route in the backend following this project's conventions (module + controller + service + dto + constants, auth/roles, pagination, prisma, tests). Use when adding or extending a backend API.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | add-backend-endpoint |
| description | Scaffold a new NestJS endpoint/module/route in the backend following this project's conventions (module + controller + service + dto + constants, auth/roles, pagination, prisma, tests). Use when adding or extending a backend API. |
Read backend/AGENTS.md first. Match the existing module shape (look at
src/subscription/ or src/notifications/ as references).
src/<feature>/:
<feature>.module.ts, <feature>.controller.ts, <feature>.service.ts,
dto/*.dto.ts, constants/<feature>.constants.ts.class-validator + @nestjs/swagger): validate every field; add
@MaxLength matching DB VarChar, bounds on numbers, @IsInt for integer
columns. Extend PaginationDto for list queries.@ApiTags + @ApiBearerAuth('JWT'). Auth is global; use
@Public() to opt out, @Roles(UserRole.ADMIN) to gate admins,
@CurrentUser('id') for the user id. Use ParsePositiveIntPipe on :id.
Webhooks → @Public() + @SkipThrottle().PrismaService. Use $transaction for multi-write
invariants. Throw { code, message } from constants (HttpExceptions).
Return DTOs / projected select (never leak tokens/secrets).src/app.module.ts imports.schema.prisma, then create an incremental
migration with bun run prisma:migrate (= migrate dev --name ..., which also
regenerates the client) — see the prisma-migration skill. Seed defaults in
prisma/seed*.ts if needed.<thing>.spec.ts for service/guard/pipe logic (mock Prisma as a
plain object; new Service(mockPrisma as never)).backend/): bunx tsc -p tsconfig.build.json --noEmit,
bun run build, bun run lint, bun run test.Scaffold a new mobile screen and/or API call in the Expo app following this project's conventions (design-system components, navigation, TanStack Query api/core, theme, i18n). Use when adding or extending a mobile screen or backend call.
Change the Prisma schema and create an incremental migration the standard Prisma way (migrate dev for local, migrate deploy for prod), then regenerate the client and seed. Use whenever editing backend/prisma/schema.prisma or adding/altering DB tables, columns, indexes, or enums.
Add a new environment variable to the backend the right way — boot-time validation, .env.example documentation, and typed access. Use when introducing any new backend config/secret/flag.
Audit the project against its production/deploy checklist — required secrets, migrations, store/push config, security toggles, and the verification gate. Use before a release, a deploy, or when asked if the app is production-ready.
Diagnose and fix this project's known environment, toolchain, build, and runtime traps (bun/node shell errors, ESLint version/commit failures, TS path/CSS errors, IAP/auth 500s, FCM iOS errors). Use when a command fails, a commit is blocked, or the app errors in a way that matches a known symptom.
Write unit tests following this repo's conventions for backend (NestJS, ts-jest, *.spec.ts) and mobile (jest-expo, *.test.ts, RNFB/native mocking). Use when adding test coverage for services, guards, pipes, hooks, stores, or utilities.