Prisma

Prisma Schema 设计与迁移调优助手

安装使用

复制下面这段提示词发给你的 AI(Claude / Cursor / TRAE / Codex / WorkBuddy 等),它会自动帮你完成安装:

帮我安装这个 AI Skill:Prisma。
它的用途是:Prisma Schema 设计与迁移调优助手
完整的 Skill 内容见:https://321skill.com/skills/prisma-x/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

提示词包含完整的 Skill 内容链接,AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。

使用示例

'帮我设计一个包含用户、订单和商品的 Prisma schema,并添加索引优化查询性能,然后生成对应的迁移文件。' 它会输出完整的 schema 定义,包括关系、枚举、索引,并给出 db push 或 migrate dev 的建议。如果遇到迁移冲突,它还会分析差异并提供安全的迁移方案。

介绍

Prisma Skill 专为解决 Node.js 和 TypeScript 项目中 Prisma 相关的常见问题而设计。它能够帮助你设计可维护的 Prisma schema,编写类型安全的查询,并处理数据库迁移、连接池耗尽、N+1 查询等性能瓶颈。当你在 schema.prisma 中建模关系、索引、枚举、JSON 或 Decimal 列时,或者面临 db push、migrate dev、migrate deploy 等选择时,它都能提供精准建议。此外,它还能诊断并修复 P2002、P2025、P2024、P2034、P3009 等常见错误,以及处理 Lambda、Vercel 或 PgBouncer 环境下的连接池问题。

使用方式非常直接:你只需描述当前遇到的问题或目标,例如“修复迁移失败,不要丢失数据”或“优化用户查询的 N+1 问题”,Skill 就会分析你的 schema 和代码上下文,给出具体的修改方案或命令。它支持 $queryRaw 和 TypedSQL,也能帮助将 $use 中间件迁移到 client extensions,并处理 Decimal 或 BigInt 导致 JSON.stringify 出错的情况。对于 Docker、Alpine 或 CI 环境下 prisma generate 失败的问题,它也能提供解决方案。

最适合的用户群体是使用 Prisma 的后端开发者和全栈工程师,尤其是那些需要频繁处理数据库迁移、性能调优或生产环境故障排查的团队。运维开发人员也能从中受益,例如在连接池配置、迁移基线化等场景下获得指导。数据分析师如果涉及 Prisma 数据建模,同样可以借助它快速验证 schema 设计。

建议在使用时提供完整的 schema 和迁移文件上下文,以便获得更准确的诊断。注意,该 Skill 不擅长数据库服务器层面的调优(如 PostgreSQL 配置参数),也不适用于手写原生 SQL 或其他 ORM(如 TypeORM、Sequelize)。对于复杂的原生 SQL 查询优化,建议结合数据库专门的工具。

核心特点

与通用的 SQL 或 ORM 辅助工具不同,这个 Skill 深度绑定 Prisma 生态,能从 schema 设计到迁移、连接池、类型安全查询、错误码诊断进行全链路覆盖,并支持 $queryRaw、TypedSQL 等 Prisma 特有功能。

注意事项

不适用于数据库服务器性能调优、手写原生 SQL 或其他 ORM 相关场景。

常见问题

如何处理 Prisma 迁移时遇到的 P2002 唯一约束冲突?

检查数据重复或索引冲突,Skill 会分析 schema 和迁移历史,建议添加 upsert 或清理重复数据。

在 Lambda 上连接池耗尽怎么办?

Skill 会建议调整连接池大小、启用 PgBouncer 或使用 Prisma 的 DataProxy 方案。

给 AI 助手的安装指引

如果你的 AI 编程助手(Claude Code、Cursor、TRAE 等)能看到这个页面,把下面这段发给它即可自动完成安装:

请访问 https://321skill.com/skills/prisma-x/raw/index.md 读取 Prisma 的原始 Skill 定义(Markdown 格式),按其中说明在我的环境里完成安装和配置。