vespertide
声明式数据库架构管理工具，通过JSON定义自动生成迁移SQL。
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：vespertide。 它的用途是：声明式数据库架构管理工具，通过JSON定义自动生成迁移SQL。 完整的 Skill 内容见：https://321skill.com/skills/vespertide/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在使用Vespertide管理项目数据库，我在`user.json`模型里新增了一个`email`字段，类型是`varchar`并设置了唯一约束。请帮我生成应用到PostgreSQL的迁移SQL。” 它会引导你运行Vespertide CLI的差异计算命令，并输出对应的`ALTER TABLE`等SQL语句，供你审核后执行。
介绍
Vespertide 是一款声明式的数据库架构管理工具，旨在解决传统迁移脚本编写繁琐、容易出错的问题。它允许开发者使用JSON文件定义期望的数据库状态，而非手动编写一系列迁移脚本。
使用时，开发者只需定义好描述表、列、索引、外键等结构的JSON模型文件。Vespertide 会自动将当前模型与已应用的迁移历史进行对比，计算出需要执行的变更，并生成类型安全、数据库无关的迁移操作计划，最终编译为针对 PostgreSQL、MySQL 或 SQLite 的具体 SQL 语句。
它非常适合需要严谨管理数据库架构变动的后端开发、全栈开发和运维工程师。无论是启动新项目，还是在现有项目中引入更可靠的架构管理流程，Vespertide 都能显著提升效率并降低人为错误。
建议在项目早期引入，以充分利用其声明式管理的优势。注意其核心是生成迁移，而非直接执行，因此通常需要与CI/CD流程或部署脚本结合。对于已经拥有大量复杂手工迁移脚本的遗留项目，初始接入可能需要一些梳理工作。
核心特点
与常见的迁移工具（如Alembic、Flyway）需要手动编写迁移脚本不同，Vespertide采用纯声明式模型，自动计算差异并生成迁移，极大减少了手动编写SQL的认知负担和出错风险。其内置的LSP服务器提供实时语法检查、自动补全和定义跳转，为模型文件开发提供了IDE级别的体验，这是同类工具中少有的。
注意事项
不适合需要直接编写复杂、定制化原生SQL迁移语句的场景，或对现有非Vespertide管理的迁移历史进行反向工程。
常见问题
Vespertide 和直接写 SQL 迁移文件有什么区别？
Vespertide 让你声明“想要什么状态”，它自动计算“如何从当前状态变过去”，避免了手动编写正向/回滚SQL的繁琐和错误，并保证迁移的类型安全与多数据库兼容。
它支持哪些数据库？
目前稳定支持 PostgreSQL、MySQL 和 SQLite。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/vespertide/raw/index.md 读取 vespertide 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/vespertide/raw/index.md（查看排版版本）