SuperAPI AI 工具集

prisma-next-upgrade

编程与开发

查看项目

更新于 10-16 07:20

技能介绍

用途:升级通过公开包 API 使用 Prisma Next 的项目(@prisma-next/postgres、@prisma-next/mongo、prisma/ 下的 contract 文件等)。若项目本身是 Prisma Next 扩展,应改用 prisma-next-extension-upgrade 技能;两者兼有时先跑本流程再跑扩展流程。

主要能力与用法: 1)先确保技能为最新版并重新加载;若运行时不支持会话内刷新,退出后让用户重新安装:pnpm dlx skills add prisma/prisma-next/skills/upgrade --all,再重新调用。 2)升级前做扩展兼容预检:读取 prisma-next.config.ts(或项目根等价 TS 配置),枚举 extensions 引入的包;对每个扩展读取 node_modules/<包名>/package.json,找出 dependencies、peerDependencies、optionalDependencies 中的 @prisma-next/* 精确版本(无 caret、无范围);取所有扩展中的最低固定版本,即当前扩展集可达的最高 Prisma Next 版本。若目标高于该最低固定版本,须中止并列出落后的扩展及其固定版本,给用户两条路径:等待扩展发布兼容版本,或用 --to=<最高可达版本> 重跑;不得自动降级、跳过或强行越过。若配置缺失或无扩展,跳过预检。 3)角色检测:package.json 在 dependencies / devDependencies 中声明了一个或多个 @prisma-next/* 包,且该包自身不是扩展,则适用本技能;角色不明确时询问用户。 4)版本检测:从 pnpm-lock.yaml(或 package-lock.json / yarn.lock)读取任一 @prisma-next/* 的已解析版本作为起始版本,若存在多个不同 minor,取最低 minor;目标版本由用户指定,或取 npm view @prisma-next/postgres dist-tags.latest,并在继续前向用户报告两者。 5)过渡链:若跨越多个 minor(如 0.6→0.8),拆成单 minor 步骤 0.6→0.7→0.8 按序完整执行,每步都先完成“改版本、安装、按说明执行、校验、提交”后才进入下一步,第一步失败即中止链路,不得跳过。 6)每步流程:把 package.json 中每个 @prisma-next/* 条目改为精确目标版本(无 caret、无 tilde,dependencies 与 devDependencies 都覆盖;升级技能本身随 pnpm dlx skills add 提供,位于 .agents/skills/prisma-next-upgrade/ 或等效 CLI 目录,没有对应的 npm 包需要提升);运行 pnpm install(或项目自身锁文件管理命令)——此时代码对新类型会报错,需要按升级说明修复;读取本技能包中 upgrades/<from>-to-<to>/instructions.md,解析 YAML frontmatter,重点关注 changes[];对每项改动,如有 detection 块(glob + 内容谓词)则先检测,无文件匹配就跳过,无 detection 则无条件应用;若条目指定脚本,从项目根调用:.ts 用 pnpm exec tsx <路径>,.sh 用 bash <路径>,codemod 按脚本文档说明执行,无脚本则直接照正文执行;changes[] 为空(占位形态,表示无用户侧破坏性改动)则视为无操作,直接进入校验。 7)校验:运行 pnpm typecheck && pnpm test(或项目 package.json scripts 中的等价命令);若失败,中止链路,不自动回滚,向用户给出失败改动的 id、涉及文件路径与推断的修复建议。 8)提交:每步一个提交,包含 package.json 修改、锁文件变动和源码改写,消息形如 chore: upgrade @prisma-next/* 到 <to-version>(或用项目自身约定),绝不压缩步骤。

完成后报告:应用了步数、产生的提交 SHA,以及遗留待办(例如升级前就已失败、升级后仍失败的测试)。

失败处理:步骤失败时给出结构化错误码 PN-UPGRADE-NNNN、失败改动 id、涉及文件路径(或锁文件、校验命令)与推断修复建议;不自动重试、不自动回滚,用户可自行还原。若预检中止,则不做任何版本提升,项目保持不变。

限制:仅适用于使用公开包 API 的应用项目,不适用于扩展包自身;升级目标受已安装扩展的最低固定版本约束,不能越级;升级说明与脚本需来自最新技能包。