SuperAPI AI 工具集

laravel-migrations

编程与开发

查看项目

更新于 10-28 08:31

技能介绍

用途

该技能面向 Laravel 13 的数据库迁移工作,用于在设计与编写数据库结构时,为智能体提供 Laravel Schema Builder 的用法规范。资料说明它适用于设计数据库 schema 和管理迁移这两类场景。

主要能力

资料列出的能力覆盖:

  • Schema Builder:创建、修改、删除数据表。
  • 列类型:50 多种列类型及其修饰符。
  • 索引:主键、唯一、全文、空间索引。
  • 外键:带级联选项的约束。
  • Seeders:向表中填充数据。
  • 高级主题:迁移测试、生产环境部署、故障排查。
  • Laravel 13 的 pgvector:通过 Schema::ensureVectorExtensionExists() 启用向量扩展,并用 vector('embedding', dimensions: 1536) 定义向量列、以 hnsw 建立索引。

使用方式

资料给出一个强制的代理工作流:实现前在确有帮助时调用 Codex 子代理能力,建议并行执行三项检查:用 fuse-ai-pilot:explore-codebase 查看已有迁移、用 fuse-ai-pilot:research-expert 经 Context7 核对 Laravel 13 模式、用 mcp__context7__query-docs 查询具体 Schema Builder 特性;实现后运行 fuse-ai-pilot:sniper 做验证。

在决策上,技能提供了迁移类型决策树(新表、加列、改列、加索引、种子数据对应的 make:migration 或 make:seeder 命令)、列类型选择表(如 id()、foreignId()->constrained()、uuid()->primary()、enum、json、decimal、timestamps、softDeletes)以及外键级联选择表(restrictOnDelete、cascadeOnDelete、nullOnDelete、noActionOnDelete 及各自适用场景)。

技能还包含参考文档索引(schema.md、columns.md、indexes.md、foreign-keys.md、commands.md、seeding.md、testing.md、production.md、troubleshooting.md)、模板清单(建表、改表、透视表、Seeder、迁移测试),以及建表、修改表、常用 Artisan 命令的快速参考代码。命令包括 make:migration、migrate、migrate:rollback --step=1、migrate:fresh --seed,并建议使用 --pretend 预览 SQL。

适用场景

适合在 Laravel 项目中新建表、增加或修改列、添加索引、建立外键、编写 Seeder、设计多对多透视表、编写迁移测试,以及在 PostgreSQL 上为向量检索(嵌入与语义搜索)建立向量列和索引时使用。向量相似查询部分资料指向另一个条目 laravel-vector-search。

关键规则与限制

资料强调:始终定义 down() 以保证迁移可逆转;外键使用 foreignId()->constrained() 而非原始 unsignedBigInteger;为外键添加索引;部署前测试回滚;不要修改已部署的迁移,应新建迁移;不要遗漏 down();不要绕开 Schema Builder 写原始 SQL;不要跳除外键索引。

资料未提供该技能的收费、价格、支持的平台、具体效果数据或安装方式,这些信息暂未提供。