迁移生成器:为 ORM 自动生成 SQL 迁移文件 - Openclaw Skills

作者:互联网

2026-04-14

AI教程

什么是 迁移生成器?

迁移生成器是一款专门设计的工具,旨在弥合现代 ORM 模型与原始数据库状态管理之间的差距。通过分析您现有的模型定义,它会自动生成健壮的 SQL 迁移文件,其中包括 UP(升级)和 DOWN(回滚)操作,确保您的数据库生命周期保持可预测和可管理。作为 Openclaw Skills 生态系统中的关键组件,此工具消除了为架构更改编写复杂 SQL 的手动开销,同时保持了数据库版本控制的高标准。

该技能专为速度和可靠性而构建,支持广泛使用的 ORM,如 Prisma、Drizzle、TypeORM 和 Sequelize。Openclaw Skills 用户可以将此工具零配置集成到他们的开发环境中,在不损害生产数据库结构完整性的情况下实现快速的架构迭代。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lxgicstudios/migration-gen

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install migration-gen

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 /skills/

优先级:工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 migration-gen。如果尚未安装 Clawhub,请先安装(npm i -g clawhub)。

迁移生成器 应用场景

  • 每当应用程序架构发生变化时,创建精确的 SQL 迁移文件。
  • 将高级 ORM 定义转换为原始 SQL 脚本,以实现更安全的生产部署。
  • 在多开发人员团队中标准化迁移文件夹结构。
  • 学习正确的迁移语法和 SQL 保护子句的实现。
迁移生成器 工作原理
  1. 该工具通过扫描本地目录识别您项目的 ORM 模型文件。
  2. 它解析模型定义和关系,以检测所需的数据库结构更改。
  3. 系统生成幂等的 SQL 语句,用于应用 (UP) 和撤销 (DOWN) 更改。
  4. 它创建一个包含 up.sql 和 down.sql 文件的带时间戳的文件夹,确保数据库演变的按时间顺序记录。

迁移生成器 配置指南

要在 Openclaw Skills 框架内使用此工具,请确保您拥有 Node.js 18+ 以及 AI 提供商的有效环境变量。

# 设置您的 API 密钥
export OPENAI_API_KEY='your_api_key_here'

# 通过 npx 运行生成器
npx ai-migrate --orm prisma --name create_profile_table

迁移生成器 数据架构与分类体系

该技能将生成的迁移组织到专为版本控制系统设计的严格文件系统层次结构中。

组件 格式 描述
目录名称 YYYYMMDDHHMMSS_name/ 用于组织 SQL 文件的按时间排序的文件夹。
up.sql SQL 脚本 将更改应用于数据库所需的迁移逻辑。
down.sql SQL 脚本 撤销特定迁移所需的回滚逻辑。
SQL 保护子句 IF NOT EXISTS 自动包含安全保护,以防止执行错误。
name: migration-gen
description: Generate SQL migration files from ORM schemas. Use when managing database changes.

Migration Generator

Your ORM schema changed and you need migration files. This tool reads your schema and generates timestamped UP and DOWN migrations.

One command. Zero config. Just works.

Quick Start

npx ai-migrate --orm prisma --name add_users

What It Does

  • Reads Prisma, Drizzle, TypeORM, or Sequelize schemas
  • Generates timestamped migration folders
  • Creates both UP and DOWN SQL
  • Includes proper guards (IF NOT EXISTS, etc.)

Usage Examples

# Prisma migration
npx ai-migrate --orm prisma --name add_users

# Drizzle with custom output
npx ai-migrate --orm drizzle --name add_orders --output ./db/migrations

# TypeORM
npx ai-migrate --orm typeorm --name add_products

Best Practices

  • Test migrations locally - run up and down before deploying
  • Keep them small - one logical change per migration
  • Version control them - migrations are code
  • Never edit deployed migrations - create new ones instead

When to Use This

  • Schema changes need migration files
  • Converting ORM operations to raw SQL
  • Setting up migration workflow
  • Learning proper migration structure

Part of the LXGIC Dev Toolkit

This is one of 110+ free developer tools built by LXGIC Studios. No paywalls, no sign-ups, no API keys on free tiers. Just tools that work.

Find more:

  • GitHub: https://github.com/LXGIC-Studios
  • Twitter: https://x.com/lxgicstudios
  • Substack: https://lxgicstudios.substack.com
  • Website: https://lxgicstudios.com

Requirements

No install needed. Just run with npx. Node.js 18+ recommended. Needs OPENAI_API_KEY environment variable.

npx ai-migrate --help

How It Works

Finds your ORM schema files, parses the model definitions, and generates SQL migration files. Creates timestamped folders with up.sql and down.sql that are safe to run multiple times.

License

MIT. Free forever. Use it however you want.

相关推荐