AgentSkillsCN

mern-add-feature

以 API 路由、Zod 数据校验规则、Mongoose 数据模型，以及 UI 组件为基础，快速搭建新功能。

SKILL.md
--- frontmatter
name: mern-add-feature
description: Scaffold a new feature with API route, Zod schema, Mongoose model, and UI components.
argument-hint: "<feature-name> [--no-ui] [--no-api] [--no-model]"
disable-model-invocation: true
allowed-tools: Bash, Write, Read, Glob, Grep

Purpose

Add a complete feature slice to an existing MERN project with all layers wired up and tests included.

Arguments

  • •feature-name — Feature name in kebab-case (e.g., user-profile, invoice)
  • •--no-ui — Skip UI components (API-only feature)
  • •--no-api — Skip API route (frontend-only feature)
  • •--no-model — Skip Mongoose model (use existing model)

What gets created

Default (all layers)

code
packages/shared/schemas/<feature>.ts           # Zod schemas + inferred types
apps/web/src/app/api/<feature>/route.ts        # API route handler
apps/web/src/server/db/models/<feature>.ts     # Mongoose model
apps/web/src/components/<feature>/         # UI components
  <Feature>List.tsx
  <Feature>Form.tsx
  <Feature>Card.tsx
apps/web/src/components/<feature>/__tests__/
  <Feature>Form.test.tsx

With flags

  • •--no-ui: Only schema + API + model
  • •--no-api: Only schema + UI (for client-side-only features)
  • •--no-model: Only schema + API route + UI (uses existing model)

Conventions

Naming

  • •Feature name: kebab-case (input)
  • •Schema/types: PascalCase (e.g., UserProfile, CreateUserProfileInput)
  • •Files: kebab-case.ts for utilities, PascalCase.tsx for React
  • •API routes: /api/<feature> for collection, /api/<feature>/[id] for item

Schema location

All Zod schemas go in packages/shared/schemas/<feature>.ts:

  • •Create<Feature>Schema — creation input
  • •Update<Feature>Schema — partial update input
  • •<Feature>Schema — full entity shape
  • •Inferred types exported alongside schemas

API route structure

  • •GET /api/<feature> — list (paginated)
  • •POST /api/<feature> — create
  • •GET /api/<feature>/[id] — get one
  • •PATCH /api/<feature>/[id] — update
  • •DELETE /api/<feature>/[id] — delete

Model conventions

  • •Timestamps enabled
  • •Indexes documented with reason
  • •toJSON transform to hide internal fields

Workflow

  1. •Create Zod schemas in packages/shared
  2. •Create Mongoose model (if not --no-model)
  3. •Create API routes (if not --no-api)
  4. •Create UI components (if not --no-ui)
  5. •Create tests for each layer
  6. •Run pnpm lint and pnpm test to verify

Output

Summarize: files created, API endpoints available, components ready to use.

Reference

For templates and patterns, see reference/mern-add-feature-reference.md