菜单
Prisma-to-Zod schema generator with composable Query Engine. Use when user mentions zodipus, prisma zod schemas, prisma validation, zod from prisma, query builders with zod, runtime database validation, or type-safe prisma queries.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/bratsos/zodipus --skill zodipus命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Define custom Zod schemas for Prisma JSON fields using @zodSchema annotations. Use when working with typed JSON, metadata fields, settings objects, complex JSON structures in Prisma, or custom-schemas.ts.
Migrate to Zodipus from other Prisma-Zod generators like prisma-zod-generator, zod-prisma, zod-prisma-types, or zmodel. Use when switching from another Prisma validation library.
Build type-safe, composable Prisma queries with automatic Zod validation. Use when working with createRegistry, query builders, select/include patterns, validated database queries, findMany validation, or type-safe Prisma results.
正在显示 SKILL.md
| name | zodipus |
| description | Prisma-to-Zod schema generator with composable Query Engine. Use when user mentions zodipus, prisma zod schemas, prisma validation, zod from prisma, query builders with zod, runtime database validation, or type-safe prisma queries. |
| license | MIT |
| metadata | {"author":"zodipus","version":"1.0.0"} |
Type-safe Zod schema generator for Prisma with composable Query Engine.
| User Intent | Skill |
|---|---|
| Install, setup, configure generator | zodipus-setup |
| Query engine, createRegistry, type-safe queries | zodipus-query-engine |
| JSON fields, @zodSchema, custom schemas | zodipus-custom-schemas |
| Errors, validation failed, not working | zodipus-troubleshooting |
| Migrate from other generators |
zodipus-migration |
Zodipus is a Prisma generator that outputs Zod schemas:
generator zodipus {
provider = "zodipus"
output = "./generated"
}
Generated schemas contain scalar fields only (no relations). This keeps validation fast and focused:
// Generated UserSchema validates: id, email, name, role, createdAt, updatedAt
// Does NOT include: posts, comments, profile (relations)
const user = UserSchema.parse(data);
Build composable queries with automatic validation:
import { createRegistry } from 'zodipus/queryEngine';
import { models, modelRelations } from './generated/generated-index';
const registry = createRegistry({ models, relations: modelRelations });
const userQuery = registry.createQuery('user');
const query = userQuery({
select: { id: true, email: true },
posts: { select: { title: true } }
});
const result = query.parse(await prisma.user.findFirst(query.query));
// Fully typed: { id: string; email: string; posts: { title: string }[] }
Type Prisma JSON fields with @zodSchema:
model Post {
/// @zodSchema PostMetadataSchema
metadata Json?
}
npm install zodipus zod
generator client {
provider = "prisma-client-js"
}
generator zodipus {
provider = "zodipus"
output = "./generated"
}
model User {
id String @id @default(cuid())
email String @unique
name String?
posts Post[]
}
model Post {
id String @id @default(cuid())
title String
author User @relation(fields: [authorId], references: [id])
authorId String
}
npx prisma generate
import { UserSchema, PostSchema } from './generated';
import { createRegistry } from 'zodipus/queryEngine';
import { models, modelRelations } from './generated/generated-index';
// Direct validation
const user = UserSchema.parse(userData);
// Query with validation
const registry = createRegistry({ models, relations: modelRelations });
const query = registry.createQuery('user')({
select: { id: true, email: true, name: true }
});
const users = await prisma.user.findMany(query.query);
const validated = query.array().parse(users);
After running prisma generate, Zodipus creates:
| File | Contents |
|---|---|
enums.ts | Prisma enums as Zod schemas |
models.ts | Clean model schemas (no relations) |
custom-schemas.ts | Placeholder for @zodSchema definitions |
generated-relations.ts | Relation metadata for Query Engine |
generated-index.ts | Re-exports and convenience exports |
| Priority | Feature | When to Use |
|---|---|---|
| Critical | UserSchema.parse() | Validate any model data |
| Critical | createRegistry() | Set up Query Engine |
| High | query.array().parse() | Validate findMany results |
| High | query.safeParse() | Handle errors without throwing |
| Medium | @zodSchema annotation | Type JSON fields |
| Medium | relationDepth config | Deep nested queries |
| Low | CLI inspect command | Debug schema issues |
See references/QUICK-REFERENCE.md for a complete cheat sheet.
基于 SOC 职业分类