AgentSkillsCN

form-creator

创建表单、验证模式及 CRUD API 端点。当构建新的数据录入功能或管理现有表单时使用。

SKILL.md
--- frontmatter
name: form-creator
description: Create forms, validation schemas, and CRUD API endpoints. Use when building new data entry features or managing existing forms.

Form Creator

Instructions

1. Validation Schema

  • File: src/lib/validations/{feature}.schema.ts
  • Action: Define Zod schema and export inferred type.
    typescript
    export const featureSchema = z.object({ ... });
    export type FeatureFormValues = z.infer<typeof featureSchema>;
    

2. Form Component

  • File: src/components/forms/{feature}-form.tsx
  • Directives: "use client"; required.
  • Setup: Use useForm with zodResolver.
  • Props: Accept initialData and onSubmit.
  • UI: Use Shadcn components (Form, FormField, Input).

3. API Routes

  • File: src/app/api/{feature}/route.ts
  • Security: Wrap with withAuthRequired or withSuperAdminAuthRequired.
  • Logic:
    • GET: Handle pagination/search.
    • POST: Validate body against schema -> Insert to DB.
    • PATCH: Validate partial body -> Update DB.

Reference

For code patterns, best practices, and examples, see reference.md.