Prisma

Prisma 全生命周期专家,从 schema 到迁移与优化

安装使用

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

帮我安装这个 AI Skill:Prisma。
它的用途是:Prisma 全生命周期专家,从 schema 到迁移与优化
完整的 Skill 内容见:https://321skill.com/skills/prisma-x-5/raw/index.md
请读取该页面内容,如果是 SKILL.md 格式直接安装,如果是 README 提炼核心 prompt 后安装。

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

使用示例

'我的 Prisma 迁移在 CI 中失败,错误码 P2025,并且查询时 Include 了过多关联导致响应慢,帮我修复。' 它会先分析 schema 和迁移文件,指出 P2025 是关联记录不存在导致的删除失败,然后给出修改迁移脚本的方案,并建议将 Include 改为按需查询或使用 raw query 来优化性能。

介绍

这个 Skill 专门解决 Prisma 使用中的各种痛点:当你编辑 schema.prisma 时帮你设计表和关系,在迁移失败、漂移或重命名列会丢数据时给出修复方案,还能处理连接池耗尽、N+1 查询、事务超时、死锁等性能问题。它覆盖了 Prisma 的完整工作流,包括 db push / migrate dev / migrate deploy 的选择、TypedSQL 和 $queryRaw 的使用、以及 $use 中间件向 client extensions 的迁移。

使用时只需描述你的 Prisma 场景,比如“修复迁移错误 P2002”或“优化 Include 加载过多导致的慢查询”,它会分析你的 schema 和代码,给出具体的修改建议和命令。它还能帮你在 Docker、Alpine 或 CI 环境中解决 prisma generate 失败的问题,并支持种子数据编写和测试隔离。

适合后端开发、全栈开发者以及使用 Prisma 的 Node.js/TypeScript 项目团队。无论是日常开发还是排查线上故障,它都能快速定位问题并给出可操作的解决方案,尤其适合对 Prisma 迁移和数据模型设计不熟悉的开发者。

注意:这个 Skill 不处理数据库服务器本身的调优(如索引优化、查询计划分析),也不支持手写原生 SQL 或其他 ORM 的迁移。建议与数据库原生工具配合使用,例如用 pg_stat_statements 分析慢查询时再结合本 Skill 优化 Prisma 查询。

核心特点

同类 Skill 往往只覆盖 Prisma 的某一方面(如 schema 生成或迁移修复),而本 Skill 同时处理连接池、N+1 问题、事务死锁、Decimal/BigInt 序列化、TypedSQL 等边缘场景,并且针对常见错误码(P2002、P2025 等)提供直接解决方案。

注意事项

不适用于数据库服务器性能调优、手写原生 SQL 或其他 ORM(如 TypeORM、Drizzle)的迁移与查询优化。

常见问题

Prisma 迁移时出现 P2002 错误怎么办?

P2002 表示唯一约束冲突,通常是因为插入重复数据或迁移中修改了唯一字段。这个 Skill 会帮你分析 schema 和现有数据,提供回滚或修改迁移脚本的建议。

如何优化 Prisma 的 N+1 查询问题?

使用 include 或 select 时容易产生 N+1,这个 Skill 会建议改用 batch 加载、raw query 或 TypedSQL,并给出具体的代码示例。

给 AI 助手的安装指引

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

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