prisma-next

Prisma Next — 路由器

编辑你的数据契约。其余工作交给 Prisma。

此技能用于消除 Prisma Next 提示词中的歧义。当用户还没有明确选择具体工作流时（例如 “帮我了解 Prisma Next”、“解释一下 Prisma Next 的工作原理”、“我是 PN 新手，该从哪里开始？”），此技能会触发，并将用户引导至相应的具体技能。

何时使用

• 用户尚未说明具体任务。
• 用户提出关于 Prisma Next 的元问题（“Prisma Next 是什么？”、“PN 与 Drizzle/Prisma 7 相比如何？”）。
• 用户请求介绍、概览或入门指引。

何时不使用

• 用户已说明工作流——直接使用匹配的技能：
  • 设置新项目或采用现有数据库 → prisma-next-quickstart。
  • 编辑架构、添加模型、更改字段 → prisma-next-contract。
  • 编写迁移、修复规划器错误 → prisma-next-migrations。
  • 检查合并时即将运行的内容、处理并发迁移 → prisma-next-migration-review。
  • 编写查询 → prisma-next-queries。
  • Supabase — RLS 策略、角色绑定（asUser / asAnon / asServiceRole）、auth.users 外键、@prisma-next/extension-supabase → prisma-next-supabase。
  • 配置 db.ts、中间件、环境配置 → prisma-next-runtime。
  • 构建系统 / 开发服务器插件（Vite、Next.js、……）→ prisma-next-build。
  • 特定错误代码或症状 → prisma-next-debug。
  • 报告 Prisma Next 的 Bug 或提交功能请求 → prisma-next-feedback。

路由规则

如果用户的提示词明显符合某项工作流技能，直接引导至该技能，无需提问。

否则，提出一个用于消除歧义的问题。从以下问题中选择：

• “你是 Prisma Next 新手，想了解它能做什么或从哪里开始吗？”（以及任何 “我能用 Prisma Next 做什么？” / “我刚运行了 createprisma” 之类的说法）→ prisma-next-quickstart（首次接触引导路径）。
• “你想设置一个新的 Prisma Next 项目，还是将它接入现有数据库？” → prisma-next-quickstart。
• “你想编辑数据契约（添加模型 / 字段 / 关系），还是处理数据库（迁移、查询）？” → prisma-next-contract 或其他技能。
• “这是关于编写迁移，还是检查部署时将要运行的内容？” → prisma-next-migrations 或 prisma-next-migration-review。
• “这是关于将 Prisma Next 接入构建工具（Vite / Next.js / …），还是在运行时配置 db.ts 和中间件？” → prisma-next-build 或 prisma-next-runtime。
• “你遇到了什么错误或症状？” → prisma-next-debug。
• “你想向 Prisma Next 团队报告 Bug，还是提交功能请求？” → prisma-next-feedback。

如果仍无法判断适用哪项技能，询问用户想做什么。不要猜测。

核心模型（一段话）

Prisma Next 是一个契约优先的数据层。你编写数据契约（contract.prisma 文件或 TypeScript 构建器）。框架会生成机器可读的产物（contract.json、contract.d.ts），并在 SQL 目标上提供三个运行时接口：类型化 SQL 查询构建器（db.sql.from(...)）、类型化 ORM 客户端（db.orm.User.select(...)）和原始 SQL 逃生通道（db.sql.raw(...)）。在 MongoDB 目标上，只有 ORM 通道可用，其键是集合存储名称（db.orm.users），而非 PSL 模型名称——prisma-next-queries § MongoDB ORM 寻址介绍了相关规则。迁移根据契约差异进行规划；你审核迁移，可选择编辑 migration.ts 以转换数据，然后应用迁移。

用户要做的三个步骤：

1. 编辑数据契约。（prisma-next-contract）
2. 系统为你规划迁移。（prisma-next-migrations）
3. 如果需要数据迁移，则编辑 migration.ts 并执行。（prisma-next-migrations）

其他所有内容——查询、运行时接线、构建集成、调试、反馈——都基于这三个步骤。

检查清单

• 如果提示词符合某项特定工作流技能，则直接转到该技能，无需询问。
• 如果提示词含糊不清，则询问一个用于消除歧义的问题。
• 不要使用此技能回答用户的问题——先加载正确的特定技能。
• 如果用户描述了缺失的功能或希望修复的异常行为，则转到 prisma-next-feedback。