SuperAPI AI 工具集

build-backend-database

编程与开发

查看项目

更新于 10-16 09:44

技能介绍

用途:在需要新增或修改数据库表、编写迁移、设计索引、优化慢查询、处理数据约束或制定生产数据修复计划时使用。不适用于仅改 API 字段命名或校验、纯前端状态与缓存逻辑、实现业务代码、以及不涉及 schema/查询设计的 ORM 使用问题。\n\n主要能力与规则:以数据库约束为数据完整性最后防线,优先在 DDL 声明主键、外键、NOT NULL、UNIQUE、CHECK、DEFAULT;所有 schema 变化进入迁移文件并带 rollback plan,在 staging 验证;生产迁移默认 expand→migrate/backfill→contract 分步进行;大表 ALTER、回填、建索引评估锁表风险与分批策略;复杂查询用 EXPLAIN / EXPLAIN ANALYZE 验证执行计划,按 WHERE、JOIN、ORDER BY 模式建索引;识别并消除 N+1 查询;多表一致性写入定义事务边界,事务内禁止调用外部 API,高并发状态更新评估乐观锁或行锁;生产数据修复需 dry-run、备份、分批、审计日志与修复后验证。迁移按 Low/Medium/High/Critical 风险分级,各有对应要求。\n\n使用方式:按四步流程执行——设计 schema 与约束、写迁移并分级风险、执行迁移并验证回滚、建索引并做查询验证;完成后回到 build-workflow-execute 继续下一个切片,前置加载 CANON.md。辅助参考 references/database-examples.md。\n\n限制:具体 DDL、锁行为与安全索引操作以当前数据库引擎为准,不确定时先查数据库文档。常用约定如复数 snake_case 表名、UUID/BIGSERIAL 主键、TIMESTAMPTZ、软删除 deleted_at 为项目约定而非绝对标准。