SuperAPI AI 工具集

migration-patterns

数据与分析

查看项目

更新于 10-16 09:30

技能介绍

用途:该技能面向 SQLite 数据库迁移场景,适用于创建迁移、修改表结构或执行数据库变更时参考。

主要能力与原则:采用双轨做法,即在 migrations/ 目录新建迁移文件,同时更新 schema.sql;命名格式为 {number}_{description}.sql,例如 001_add_tags.sql;编号使用零填充(001、002、003),按字母顺序执行;语句始终使用 IF NOT EXISTS 以保证幂等;每个迁移只做一个功能,保持聚焦;建表时在同一迁移中加入索引;迁移一旦提交就不再修改,而是新建迁移。

示例写法:迁移文件包含注释头(迁移名、创建日期、说明),使用 CREATE TABLE IF NOT EXISTS 建表,字段包含主键、外键、时间戳等,并使用 CREATE INDEX IF NOT EXISTS 建立索引。资料中的示例为创建 tags 表并添加 user_id 索引。

参考文件:references/migration-guide.md 提供完整工作流与示例,references/troubleshooting.md 说明常见问题。

使用方式:按上述命名与双轨规则编写迁移文件并同步 schema.sql;资料还提到可用 claude-skills-cli validate <path> 校验,出现多行描述警告时可用 claude-skills-cli doctor <path> 处理,然后再次校验确认。

限制:资料未说明支持的具体数据库版本、部署方式、性能影响或回滚策略,这些信息暂未提供。