SuperAPI AI 工具集

prisma-next-extension-upgrade

通用与其它

查看项目

更新于 10-16 07:20

技能介绍

用途:该技能用于升级 Prisma Next 扩展项目。扩展指消费框架 SPI(如 @prisma-next/contract、@prisma-next/framework-components、@prisma-next/migration-tools 等)并对外提供 contract、middleware、codec、migration 等能力,供下游应用通过 prisma-next.config.ts 安装的包。若项目是导入 @prisma-next/postgres 或 @prisma-next/mongo 的消费应用,应改用 prisma-next-upgrade;若同一仓库两者都有,先跑用户流程再跑本扩展流程。

主要能力:先确保技能为最新并重载;随后进行角色识别、版本检测、按单 minor 步构建过渡链并逐步执行。每步包含:把 package.json 中所有 @prisma-next/(dependencies、peerDependencies、optionalDependencies)改写为该步目标精确版本(无 ^、~、范围或 workspace:),执行 pnpm install,跑 pnpm exec prisma-next-check-pins 校验所有条目为同一精确版本,再读取该技能包内 upgrades/<from>-to-<to>/instructions.md 并按其 changes[] 逐条应用;有 detection 则先跑,无匹配可跳过;有脚本则按类型用 pnpm exec tsx 或 bash 调用,codemod 按其说明执行;最后 pnpm build && pnpm test 验证,并每步单独提交,消息为 chore: upgrade @prisma-next/ to <to-version>。链上某步失败即停止,不做自动重试或自动回滚,向用户报告结构化错误、变更 id、涉及文件与修复建议。

必要用法与命令:安装或更新技能使用 pnpm dlx skills add prisma/prisma-next/skills/extension-author --all;消费应用流程用 pnpm dlx skills add prisma/prisma-next/skills/upgrade --all;校验安装 pnpm add -D @prisma-next/extension-author-tools 后运行 pnpm exec prisma-next-check-pins。版本从锁文件(pnpm-lock.yaml、package-lock.json 或 yarn.lock)解析最低 minor 为起始版本,目标版本可为用户指定或 npm view @prisma-next/contract dist-tags.latest。

限制:仅适用于外部扩展仓库;prisma/prisma-next 单仓库内部扩展用 pnpm bump-minor / scripts/set-version.ts 处理,不走本技能。检测不明确时需询问用户角色。技能包本身与 @prisma-next/extension-author-tools 的 pin 不在升级范围内。资料未提供具体升级变更内容、失败码细节及支持平台范围。