用途:Prisma Next 的迁移审查技能,重点在审查而非编写迁移,回答部署时与多人并发落地迁移相关的问题,例如合并或部署前将运行哪些迁移、如何配置 staging/生产 ref 供 CI 使用、如何对非本地环境执行迁移。
主要能力:讲解 ref、marker、迁移图的心智模型并演示如何查询系统状态。migration status 查询从 origin(数据库当前 contract hash,在线时取自数据库 marker 表;离线时未知)到 destination(--to <name> 指向的 ref 哈希,或默认当前 contract head)之间的路径,逐边报告 applied/pending/unreachable。诊断码含 MIGRATION.UP_TO_DATE、DATABASE_BEHIND、MISSING_INVARIANTS、NO_MARKER、MARKER_NOT_IN_HISTORY、DIVERGED、CONTRACT.AHEAD、CONTRACT.UNREADABLE,以及 plan/apply 阶段的 HASH_NOT_IN_GRAPH、SNAPSHOT_MISSING、MARKER_MISMATCH、PATH_UNREACHABLE。migration status/list/graph 支持 --legend 与 --ascii 渲染迁移图为彩色泳道树,log 仅支持 --ascii。
用法示例:pnpm prisma-next migration status --to staging --db "$STAGING_DATABASE_URL";pnpm prisma-next migrate --to production --db "$PRODUCTION_DATABASE_URL";ref 操作为 ref set/list/delete(ref get 已移除);预览用 migrate --show,历史用 migration log。并发冲突需按编辑→plan→apply 重新规划,手工数据转换逻辑需自行迁移到新迁移中。
限制:migration status 仅在硬错误时返回非零,警告级诊断仍退出 0,CI 需用 --json 自行解析 diagnostics[] 判断;migrate 无交互、无破坏性操作确认,亦无 --dry-run,检查步骤即 migration status。不适用于编写迁移、修复单环境哈希漂移或编辑 contract。