SuperAPI AI 工具集

prisma-next-debug

测试与质量

查看项目

更新于 10-16 07:20

技能介绍

用途:当 Prisma Next 调用失败时,框架会返回结构化错误信封。本技能教代理识别信封形态、按 code 路由到正确的修复动作,并串联到对应的编写类技能;它本身不重复其他技能的工作流。

主要能力:区分三种错误来源——CLI 信封(prisma-next 命令产生,形如 PN-<domain>-<NNNN>,domain 有 CLI/MIG/RUN/CON/SCHEMA)、运行时信封(执行查询时抛出,category 为 PLAN/CONTRACT/LINT/BUDGET/RUNTIME,细节在 details)、以及 SQL 驱动错误(SqlQueryError/SqlConnectionError,按 sqlState、constraint、table、column 判断,非 PN-* 码)。

使用方式:用户粘贴错误信封、提到 query 无法通过类型检查、迁移无法应用、emit 失败或运行时崩溃时启用;若用户只想编写查询/模型/迁移,应转到对应编写技能;若想预防错误转到 prisma-next-runtime;若问题在于框架本身能力缺失则转到 prisma-next-feedback。只拿到摘要时,用 --json 或 -v(所有命令的全局标志)取完整信封。若 code 为 PN-RUN-3000,需再读 meta.code,真正的路由信息在那里(如 MIGRATION.HASH_MISMATCH)。

路由示例:PN-CLI-4001 提示运行 prisma-next init 或传 --config;PN-RUN-3001/3002 用 db init 或 db sign;PN-RUN-3030 需 -y 或 --dry-run;BUDGET.* 调整 budgets({ maxRows, maxLatencyMs });LINT.* 修正查询或放宽配置。

限制:路由表未覆盖的 code,按信封 fix 字段处理;fix 为空则走 prisma-next-feedback。不应把 drift 直接用 db sign 掩盖,需先通过 db verify。目前无内置 Studio/GUI、查询日志中间件、EXPLAIN 集成和面向用户的预编译语句缓存,需用文档中的替代方案或提反馈。